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 值，如下所示：
| 返回代码 | 描述 |
|---|---|
|
安全描述符的修订级别未知或不受支持。 这是一个错误代码。 |
言论
如果 SecurityDescriptor 指向的安全描述符包含主组，RtlGetGroupSecurityDescriptor 将 组指向的指针设置为安全描述符组 SID 的地址，并将 GroupDefaulted 指向的变量设置为有效值。
如果 SecurityDescriptor 指向的安全描述符不包含主组，RtlGetGroupSecurityDescriptor 将 组 指向的指针设置为 NULL，并忽略剩余的输出参数，GroupDefaulted。
若要设置安全描述符的主组信息，请使用 RtlSetGroupSecurityDescriptor。
若要检索安全描述符的所有者信息，请使用 RtlGetOwnerSecurityDescriptor。
有关安全性和访问控制的详细信息，请参阅 Microsoft Windows SDK 文档。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows Server 2003 SP1 |
| 目标平台 | 普遍 |
| 标头 | ntifs.h （include Ntifs.h） |
| 库 | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |