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