GetSecurityDescriptorGroup 関数 (securitybaseapi.h)
GetSecurityDescriptorGroup 関数は、セキュリティ記述子からプライマリ グループ情報を取得します。
構文
BOOL GetSecurityDescriptorGroup(
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor,
[out] PSID *pGroup,
[out] LPBOOL lpbGroupDefaulted
);
パラメーター
[in] pSecurityDescriptor
関数が取得するプライマリ グループ情報を持つ SECURITY_DESCRIPTOR 構造体へのポインター。
[out] pGroup
関数が返されるときにプライマリ グループを識別する セキュリティ識別子 (SID) へのポインター。 セキュリティ記述子にプライマリ グループが含まれていない場合、関数は pGroup が指すポインターを NULL に設定し、残りの出力パラメーター lpbGroupDefaulted を無視します。 セキュリティ記述子にプライマリ グループが含まれている場合、この関数は pGroup が指すポインターをセキュリティ記述子のグループ SID のアドレスに設定し、 lpbGroupDefaulted が指す変数の有効な値を提供します。
[out] lpbGroupDefaulted
関数が戻るときに、 SECURITY_DESCRIPTOR_CONTROL構造体の SE_GROUP_DEFAULTED フラグの値に設定されるフラグへのポインター。 pGroup パラメーターが指す変数に格納されている値が NULL の場合、値は設定されません。
戻り値
関数が成功した場合、関数は 0 以外の値を返します。
関数が失敗すると、0 が返されます。 詳細なエラー情報を得るには、GetLastError を呼び出します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP [デスクトップ アプリ | UWP アプリ] |
| サポートされている最小のサーバー | Windows Server 2003 [デスクトップ アプリのみ | UWP アプリ] |
| 対象プラットフォーム | Windows |
| ヘッダー | securitybaseapi.h (Windows.h を含む) |
| Library | Advapi32.lib |
| [DLL] | Advapi32.dll |