RtlGetSaclSecurityDescriptor 函数 (ntifs.h)

RtlGetSaclSecurityDescriptor 例程返回指向安全描述符的系统 ACL (SACL) 的指针。

语法

NTSYSAPI NTSTATUS RtlGetSaclSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PBOOLEAN             SaclPresent,
  [out] PACL                 *Sacl,
  [out] PBOOLEAN             SaclDefaulted
);

参数

[in] SecurityDescriptor

指向要返回其 SACL 的SECURITY_DESCRIPTOR 的指针。

[out] SaclPresent

指向指示指定安全描述符中存在 SACL 的布尔变量的指针。 如果此变量收到 TRUE,则安全描述符包含 SACL,其余输出参数接收有效值。 如果此变量收到 FALSE,则安全描述符不包含 SACL,其余输出参数不会接收有效值。

[out] Sacl

指向接收安全描述符的 SACL 地址的变量的指针。 如果安全描述符没有 SACL,则此变量不会接收值。 如果安全描述符具有 NULL SACL,则此变量接收 NULL

[out] SaclDefaulted

指向一个布尔变量的指针,如果安全描述符存在 SACL,则它接收安全描述符SECURITY_DESCRIPTOR_CONTROL结构中SE_SACL_DEFAULTED标志的值。

返回值

RtlGetSaclSecurityDescriptor 返回STATUS_SUCCESS或相应的 NTSTATUS 值,如下所示:

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

注解

有关安全性和访问控制的详细信息,请参阅Microsoft Windows SDK中的这些主题的文档。

要求

   
最低受支持的客户端 此例程在 Microsoft Windows Server 2003 SP1 及更高版本上可用。
目标平台 通用
标头 ntifs.h (包括 Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

另请参阅

Acl

RtlCreateSecurityDescriptor

RtlGetDaclSecurityDescriptor

RtlLengthSecurityDescriptor

RtlSetDaclSecurityDescriptor

RtlValidSecurityDescriptor

SECURITY_DESCRIPTOR