RtlGetSaclSecurityDescriptor 函数 (ntifs.h)

项目
02/29/2024

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

指向布尔变量的指针，该变量接收安全描述符SECURITY_DESCRIPTOR_CONTROL结构中SE_SACL_DEFAULTED标志的值（如果安全描述符存在 SACL）。

返回值

RtlGetSaclSecurityDescriptor 返回STATUS_SUCCESS或相应的 NTSTATUS 值，如下所示：

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

注解

有关安全性和访问控制的详细信息，请参阅面向驱动程序开发人员的 Windows 安全模型以及 Windows SDK 中有关这些主题的文档。

要求

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