RtlGetGroupSecurityDescriptor 函式 (ntifs.h)
RtlGetGroupSecurityDescriptor 例程會傳回指定安全性描述元的主要群組資訊。
語法
NTSYSAPI NTSTATUS RtlGetGroupSecurityDescriptor(
[in] PSECURITY_DESCRIPTOR SecurityDescriptor,
[out] PSID *Group,
[out] PBOOLEAN GroupDefaulted
);
參數
[in] SecurityDescriptor
要傳回主要群組資訊的安全性描述符指標。
[out] Group
接收主要群組之安全標識碼指標的變數指標 (SID) 。 如果安全性描述項不包含主要群組， *群組 會收到 NULL。
[out] GroupDefaulted
布爾變數的指標，該變數會接收安全性描述元SECURITY_DESCRIPTOR_CONTROL結構中SE_GROUP_DEFAULTED旗標的值。 只有在 *Group 收到非 NULL 值時，這個值才有效。
傳回值
RtlGetGroupSecurityDescriptor 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，如下所示：
| 傳回碼 | Description |
|---|---|
|
安全性描述項的修訂層級未知或不受支援。 這是錯誤碼。 |
備註
如果 SecurityDescriptor 所指向的安全性描述元包含主要群組， RtlGetGroupSecurityDescriptor 會將 Group 指向的指標設定為安全性描述項群組 SID 的位址，並將 GroupDefaulted 所指向的變數設定為有效值。
如果 SecurityDescriptor 指向的安全性描述元不包含主要群組， RtlGetGroupSecurityDescriptor 會將 Group 指向的指標設定為 NULL ，並忽略其餘的輸出參數 GroupDefaulted。
若要設定安全性描述元的主要群組資訊，請使用 RtlSetGroupSecurityDescriptor。
若要擷取安全性描述元的擁有者資訊，請使用 RtlGetOwnerSecurityDescriptor。
如需安全性和訪問控制的詳細資訊，請參閱 Microsoft Windows SDK 檔。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Server 2003 SP1 |
| 目標平台 | Universal |
| 標頭 | ntifs.h (包含 Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |