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