Sm_PolicyApi_GetUserGroups()

ユーザがメンバであるグループのリストを取得します。
casso127jpjp
ユーザがメンバであるグループのリストを取得します。
Type
ユーザとユーザ状態関数。
構文
int SM_EXTERN Sm_PolicyApi_GetUserGroups (
void *pSessionHandle,
const char *pszUserDirOid,
const char *pszUserDN,
const bool bRecursive,
char** pszGroups[]
);
パラメータ
I/O
説明
pSessionHandle
I
内部ポリシー管理 API データ構造体へのポインタ。この構造体は、管理者セッションおよびクライアント セッションに関する情報を保持します。
pszUserDirOid
I
ユーザのオブジェクト識別子。
pszUserDN
I
ユーザの識別名。
bRecursive
I
検索するのは 1 レベルのみかまたはすべてのレベルかを示す値。真を指定すると、すべてのレベルが検索されます。
pszGroups
O
ユーザが属するグループが含まれる配列。Sm_PolicyApi_FreeStringArray() を呼び出すことにより配列に割り当てられたメモリを解放します。
戻り値
  • Sm_PolicyApi_Success。取得の操作が成功しました。
  • Sm_PolicyApi_Failure。取得の操作が成功しませんでした。
  • Sm_PolicyApi_Invalid。指定されたユーザ OID および DN の有効なディレクトリはありませんでした。
  • Sm_PolicyApi_InvalidHandle。このコールに先立つ有効な初期化はありませんでした。
  • Sm_PolicyApi_InvalidOid。ディレクトリ OID が見つかりませんでした(ディレクトリ ベースのグループについて)。
  • Sm_PolicyApi_NoSession。有効な管理者セッションがありません。
  • Sm_PolicyApi_NoPrivilege。管理者には、グループを取得する権限がありません。