Sm_PolicyApi_AddToGroup()

pszGroupOid によって識別されたグループに、アイテムを追加します。
casso126jjp
pszGroupOid
によって識別されたグループに、アイテムを追加します。
アイテム(グループの場合もある)およびグループが存在し、かつ同じタイプである必要があります。
pszDomainOid
パラメータはルール グループまたはレスポンス グループに必須です。エージェント グループはドメイン ベースのオブジェクトではないので、ドメイン OID を必要としません。
Type
グループ関数、グローバル範囲(エージェント)またはドメイン範囲(レスポンス、ルール)。
構文
int SM_EXTERN Sm_PolicyApi_AddToGroup (
void*pSessionHandle,
Sm_PolicyApi_Groups_tdwGroup,
const char*pszItemOid,
const char*pszGroupOid,
const char*pszDomainOid
);
パラメータ
I/O
Description
pSessionHandle
I
内部ポリシー管理 API データ構造体へのポインタ。この構造体は、管理者セッションおよびクライアント セッションに関する情報を保持します。
dwGroup
I
グループのタイプ。
pszItemOid
I
グループと同じタイプの既存のアイテムのオブジェクト識別子が含まれ、NULL で終わる文字列です。
pszGroupOid
I
dwGroup
によって示されるタイプのグループのオブジェクト識別子が含まれ、NULL で終わる文字列です。
pszDomainOid
I
既存のドメインのオブジェクト識別子が含まれ、NULL で終わる文字列です。ルールおよびレスポンス オブジェクトに必須です。
戻り値
  • Sm_PolicyApi_Success。追加が成功しました。
  • Sm_PolicyApi_Failure。追加は成功しませんでした。
  • Sm_PolicyApi_InvalidHandle。このコールに先立つ有効な初期化はありませんでした。
  • Sm_PolicyApi_NoSession。有効な管理者セッションがありません。
  • Sm_PolicyApi_NoPrivilege。管理者には、ルール、レスポンスまたはエージェント OID をその各グループに追加する権限がありません。
  • Sm_PolicyApi_InvalidOid:
    • ドメイン OID が見つかりませんでした(ドメイン ベースのグループについて)。
    • グループ OID が見つかりませんでした。
    • ルール、レスポンス、またはエージェント OID またはグループ OID が見つかりませんでした。
  • Sm_PolicyApi_BadGroup。パラメータ
    dwGroup
    はルール、レスポンスまたはエージェント タイプではありません。