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 值，如下所示：

返回代码 说明
STATUS_UNKNOWN_REVISION
 安全描述符的修订级别未知或不受支持。 这是错误代码。

注解

如果 SecurityDescriptor 指向的安全描述符包含主组， 则 RtlGetGroupSecurityDescriptor 会将 Group 指向的指针设置为安全描述符的组 SID 的地址，并将 GroupDefaulted 指向的变量设置为有效值。

如果 SecurityDescriptor 指向的安全描述符不包含主组， 则 RtlGetGroupSecurityDescriptor 会将 Group 指向的指针设置为 NULL ，并忽略剩余的输出参数 GroupDefaulted。

若要设置安全描述符的主组信息，请使用 RtlSetGroupSecurityDescriptor。

若要检索安全描述符的所有者信息，请使用 RtlGetOwnerSecurityDescriptor。

有关安全性和访问控制的详细信息，请参阅Microsoft Windows SDK文档。

要求

要求 值
最低受支持的客户端 Windows Server 2003 SP1
目标平台 通用
标头 ntifs.h (包括 Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另请参阅

RtlGetOwnerSecurityDescriptor

RtlSetGroupSecurityDescriptor

SECURITY_DESCRIPTOR

SID