RtlGetSaclSecurityDescriptor 函式 (ntifs.h)

發行項
02/26/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

布爾變數的指標，如果安全性描述元存在 SACL，則會在安全性描述元的SECURITY_DESCRIPTOR_CONTROL結構中接收SE_SACL_DEFAULTED旗標的值。

傳回值

RtlGetSaclSecurityDescriptor 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，如下所示：

傳回碼	Description
STATUS_UNKNOWN_REVISION	安全性描述項的修訂層級未知或不受支援。這是錯誤碼。

備註

如需安全性和訪問控制的詳細資訊，請參閱適用於驅動程序開發人員的 Windows 安全性模型，以及 Windows SDK 中有關這些主題的檔。

規格需求

需求	值
最低支援的用戶端	Windows Server 2003 SP1
目標平台	Universal
標頭	ntifs.h (包含 Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= APC_LEVEL