RtlAddAccessAllowedAceEx 函式 (ntifs.h)

發行項
02/26/2024

RtlAddAccessAllowedAceEx 例程會將存取權允許的訪問控制專案新增至 ACE (ACE ) ，並將繼承 ACE 旗標新增至訪問控制清單， (ACL) 。存取權會授與指定的安全標識碼， (SID) 。

語法

NTSYSAPI NTSTATUS RtlAddAccessAllowedAceEx(
  [in, out] PACL        Acl,
  [in]      ULONG       AceRevision,
  [in]      ULONG       AceFlags,
  [in]      ACCESS_MASK AccessMask,
  [in]      PSID        Sid
);

參數

[in, out] Acl

呼叫端配置的緩衝區指標，其中包含要修改的 ACL。 RtlAddAccessAllowedAceEx 會將允許存取的 ACE 新增至此 ACL 的結尾。 ACE 的格式為 ACCESS_ALLOWED_ACE 結構。

[in] AceRevision

要新增之 ACE 的 ACL 修訂層級。此值可以是ACL_REVISION或ACL_REVISION_DS。如果 ACL 包含物件特定的 ACE，則必須ACL_REVISION_DS。

[in] AceFlags

指定要加入之 ACE 繼承旗標的位掩碼。

[in] AccessMask

一個或多個 ACCESS_MASK 旗標的位掩碼，指定要授與指定 SID 的訪問許可權。如需詳細資訊，請參閱 ZwCreateFile的 DesiredAccess 參數描述。

[in] Sid

SID 結構的指標，表示正在授與存取權的使用者、群組或登入帳戶。

傳回值

RtlAddAccessAllowedAceEx 可以傳回下列其中一個值：

傳回碼	Description
STATUS_SUCCESS	已成功新增 ACE。
STATUS_ALLOTTED_SPACE_EXCEEDED	新的 ACE 不適用於 ACL。需要較大的 ACL 緩衝區。如需如何計算 ACL 大小的詳細資訊，請參閱 RtlCreateAcl。
STATUS_INVALID_ACL	指定的 ACL 格式不正確。
STATUS_INVALID_PARAMETER	AceFlags 參數無效。
STATUS_INVALID_SID	指定的 SID 結構在結構上無效。
STATUS_REVISION_MISMATCH	指定的 AceRevision 未知或與 ACL 不相容。

備註

不同於 RtlAddAccessAllowedAce，此例程會設定繼承 ACE 旗標。

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

規格需求

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