RtlAddAce 函式 (ntifs.h)

發行項
03/01/2024

RtlAddAce 例程會將一或多個存取控制專案 (ACL) 新增至指定的存取控制清單 (ACL) 。

語法

NTSYSAPI NTSTATUS RtlAddAce(
  [in, out] PACL  Acl,
  [in]      ULONG AceRevision,
  [in]      ULONG StartingAceIndex,
  [in]      PVOID AceList,
  [in]      ULONG AceListLength
);

參數

[in, out] Acl

要修改之 ACL 的指標。 RtlAddAce 會將指定的 ACL 新增至此 ACL。

[in] AceRevision

要新增之 ACE 的 ACL 修訂層級。 Windows 版本需求如下：

值	意義
ACL_REVISION	所有 Windows 版本的修訂層級都有效。
ACL_REVISION_DS	從 Windows 2000 開始有效的修訂層級。

如果 Acl 中的 ACL 包含物件特定的 ACE，則必須ACL_REVISION_DS AceRevision。

[in] StartingAceIndex

指定 ACL 清單中要新增 ACE 的位置。值為零會在清單開頭插入 ACE。 MAXULONG的值會將 ACE 附加至清單結尾。

[in] AceList

緩衝區的指標，其中包含要加入至指定 ACL 的一或多個 ACE 清單。清單中的 ACE 必須連續儲存。

[in] AceListLength

AceList 參數所指向之輸入緩衝區的大小，以位元組為單位。

傳回值

RtlAddAce 會傳回STATUS_SUCCESS或適當的 NTSTATUS 值，例如下列其中一項：

傳回碼	Description
STATUS_BUFFER_TOO_SMALL	新的 ACE 不適用於 ACL。需要較大的 ACL 緩衝區。 STATUS_BUFFER_TOO_SMALL是錯誤碼。
STATUS_INVALID_PARAMETER	其中一個參數值無效。可能的原因包括指定的 ACL 無效或指定的修訂未知、與 ACE 清單中的修訂不相容，或與 ACL 的修訂不相容。 STATUS_INVALID_PARAMETER是錯誤碼。

備註

如需計算 ACL 大小的相關信息，請參閱 RtlCreateAcl 參考專案的一節。

若要取得 ACL 中 ACE 的指標，請使用 RtlGetAce。

若要從 ACL 刪除 ACE，請使用 RtlDeleteAce。

若要將允許存取的 ACE 新增至 ACL，請使用 RtlAddAccessAllowedAce。

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

規格需求

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