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旗標的值。 只有在 *群組 收到非NULL 值時，這個值才有效。
傳回值
RtlGetGroupSecurityDescriptor 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，如下所示：
| 傳回碼 | 描述 |
|---|---|
|
安全性描述項的修訂層級未知或不受支援。 這是錯誤碼。 |
言論
如果 SecurityDescriptor 所指向的安全性描述元 包含主要群組，RtlGetGroupSecurityDescriptor 會將 Group 所指向的指標設定為安全描述元群組 SID 的位址，並將 groupDefaulted 指向的變數設定為有效值。
如果 SecurityDescriptor 所指向的安全性描述元 不包含主要群組，RtlGetGroupSecurityDescriptor 會將 group Group 指向的指標設定為 NULL，並忽略其餘輸出參數，GroupDefaulted。
若要設定安全性描述元的主要群組資訊，請使用 RtlSetGroupSecurityDescriptor。
若要擷取安全性描述元的擁有者資訊，請使用 RtlGetOwnerSecurityDescriptor。
如需安全性和訪問控制的詳細資訊，請參閱 Microsoft Windows SDK 檔。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows Server 2003 SP1 |
| 目標平臺 | 普遍 |
| 標頭 | ntifs.h （include Ntifs.h） |
| 連結庫 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |