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 |