Sm_PolicyApi_GetGroupOids()

グループ オブジェクト内に含まれているオブジェクト識別子を取得します。この関数の結果は、ppStructObjects によって参照される構造で返されます。
casso126jjp
グループ オブジェクト内に含まれているオブジェクト識別子を取得します。この関数の結果は、
ppStructObjects
によって参照される構造で返されます。
この構造に割り当てられたメモリは、Sm_PolicyApi_FreeMemoryEx() を呼び出すことによって解放します。
pszDomainOid
はルール グループまたはレスポンス グループに必須です。エージェント グループはドメイン ベースのオブジェクトではないので、ドメイン OID を必要としません。
注:
CA Single Sign-on
v4.5 より前のリリースでは、Sm_PolicyApi_GetGroupOids() によって提供される機能は、Sm_PolicyApi_GetGroupNames() によって提供されていました。
Type
グループ関数、グローバル範囲(エージェント)またはドメイン範囲(レスポンス、ルール)。
構文
int SM_EXTERN Sm_PolicyApi_GetGroupOids (
void*pSessionHandle,
Sm_PolicyApi_Groups_tdwGroup,
const char*pszGroupOid,
const char*pszDomainOid,
Sm_PolicyApi_Oid_t**ppStructObjects
);
パラメータ
I/O
Description
pSessionHandle
I
内部ポリシー管理 API データ構造体へのポインタ。この構造体は、管理者セッションおよびクライアント セッションに関する情報を保持します。
dwGroup
I
オブジェクト識別子が取得されるグループのタイプを示します。
pszGroupOid
I
dwGroup
によって示されるタイプのグループのオブジェクト識別子が含まれ、NULL で終わる文字列です。
pszDomainOid
I
既存のドメインのオブジェクト識別子が含まれ、NULL で終わる文字列です。ルールまたはレスポンス グループの必須パラメータです。
ppStructObjects
O
オブジェクト構造のアドレスへのポインタです。
戻り値
  • Sm_PolicyApi_Success。取得は正常に行われました。
  • Sm_PolicyApi_Failure。取得の操作が成功しなかったか、または Sm_PolicyApi_Oid_t にメモリを割り当てることができませんでした。
  • Sm_PolicyApi_InvalidHandle。このコールに先立つ有効な初期化はありませんでした。
  • Sm_PolicyApi_NoSession。有効な管理者セッションがありません。
  • Sm_PolicyApi_NoPrivilege。管理者には、グループ OID を取得する権限がありません。
  • Sm_PolicyApi_InvalidOid:
    • グループ OID が見つかりませんでした。
    • ドメイン OID が見つかりませんでした(ドメイン ベースのグループについて)。
  • Sm_PolicyApi_BadGroup。パラメータ
    dwGroup
    はルール、レスポンスまたはエージェント タイプではありません。