GetSecurityDescriptorGroup 関数 (securitybaseapi.h)

[アーティクル]
03/01/2024

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