RtlGetGroupSecurityDescriptor 関数 (ntifs.h)
RtlGetGroupSecurityDescriptor ルーチンは、特定のセキュリティ記述子のプライマリ グループ情報を返します。
構文
NTSYSAPI NTSTATUS RtlGetGroupSecurityDescriptor(
[in] PSECURITY_DESCRIPTOR SecurityDescriptor,
[out] PSID *Group,
[out] PBOOLEAN GroupDefaulted
);
パラメーター
[in] SecurityDescriptor
プライマリ グループ情報が返されるセキュリティ記述子へのポインター。
[out] Group
プライマリ グループのセキュリティ識別子 (SID) へのポインターを受け取る変数へのポインター。 セキュリティー記述子に 1 次グループが含まれていない場合、 *Group は NULL を受け取ります。
[out] GroupDefaulted
セキュリティ記述子のSECURITY_DESCRIPTOR_CONTROL構造でSE_GROUP_DEFAULTED フラグの値を受け取るブール型 (Boolean) の変数へのポインター。 この値は、 *Group が NULL 以外の値を受け取る場合にのみ有効です。
戻り値
RtlGetGroupSecurityDescriptor は、次のようなSTATUS_SUCCESSまたは適切な NTSTATUS 値を返します。
| リターン コード | 説明 |
|---|---|
|
セキュリティ記述子のリビジョン レベルが不明であるか、サポートされていません。 これはエラー コードです。 |
注釈
SecurityDescriptor が指すセキュリティ記述子にプライマリ グループが含まれている場合、RtlGetGroupSecurityDescriptor は Group が指すポインターをセキュリティ記述子のグループ SID のアドレスに設定し、GroupDefaulted が指す変数を有効な値に設定します。
SecurityDescriptor が指すセキュリティ記述子にプライマリ グループが含まれていない場合、RtlGetGroupSecurityDescriptor は Group が指すポインターを NULL に設定し、残りの出力パラメーター GroupDefaulted を無視します。
セキュリティ記述子のプライマリ グループ情報を設定するには、 RtlSetGroupSecurityDescriptor を使用します。
セキュリティ記述子の所有者情報を取得するには、 RtlGetOwnerSecurityDescriptor を使用します。
セキュリティとアクセス制御の詳細については、Microsoft Windows SDKドキュメントを参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Server 2003 SP1 |
| 対象プラットフォーム | ユニバーサル |
| Header | ntifs.h (Ntifs.h を含む) |
| Library | NtosKrnl.lib |
| [DLL] | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |