Sm_PolicyApi_GetPolicyUsers()
pszPolicyOid によって識別されるポリシーと関連付けられ、オプションで pszUserDirOid によって識別されるユーザ ディレクトリに属するユーザに対応する Sm_PolicyApi_User_t 構造のリンク リストを返します。この構造に割り当てられたメモリは、Sm_PolicyApi_FreeMemoryEx() を呼び出すことによって解放します。
casso1283
pszPolicyOid
によって識別されるポリシーと関連付けられ、オプションで pszUserDirOid
によって識別されるユーザ ディレクトリに属するユーザに対応する Sm_PolicyApi_User_t 構造のリンク リストを返します。この構造に割り当てられたメモリは、Sm_PolicyApi_FreeMemoryEx() を呼び出すことによって解放します。Type
ユーザとユーザ状態関数。
構文
int SM_EXTERN Sm_PolicyApi_GetPolicyUsers (void*pSessionHandle,const char*pszPolicyOid,const char*pszUserDirOid,Sm_PolicyApi_User_t**ppStructUsers);
パラメータ | I/O | 説明 |
pSessionHandle | I | 内部ポリシー管理 API データ構造体へのポインタ。この構造体は、管理者セッションおよびクライアント セッションに関する情報を保持します。 |
pszPolicyOid | I | 既存のポリシーのオブジェクト識別子が含まれ、NULL で終わる文字列です。 |
pszUserDirOid | I | 既存のユーザ ディレクトリのオブジェクト識別子が含まれ、NULL で終わる文字列です。このパラメータは任意です。これが空白の場合、関数は指定されたポリシー下のポリシー ユーザすべてを返します。これが指定されている場合、関数は指定されたポリシー下のこのディレクトリに属するポリシー ユーザを返します。 |
ppStructUsers | O | ユーザ構造のリンク リストへのポインタのアドレスです。 |
戻り値
- Sm_PolicyApi_Success。取得の操作が成功しました。
- Sm_PolicyApi_Failure。メモリを Sm_PolicyApi_User_t に割り当てることができませんでした。
- Sm_PolicyApi_InvalidHandle。このコールに先立つ有効な初期化はありませんでした。
- Sm_PolicyApi_NoSession。有効な管理者セッションがありません。
- Sm_PolicyApi_NoPrivilege。管理者には、ポリシーからユーザを取得する権限がありません。
- Sm_PolicyApi_InvalidOid:
- ポリシー OID が見つかりませんでした。
- ユーザ ディレクトリ OID が見つかりませんでした。