RtlGetSaclSecurityDescriptor 函数（ntifs.h）

项目
02/07/2025

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	安全描述符的修订级别未知或不受支持。这是一个错误代码。

言论

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

要求

要求	价值
最低支持的客户端	Windows Server 2003 SP1
目标平台	普遍
标头	ntifs.h （include Ntifs.h）
库	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL