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 会将 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 |