(ntifs.h) RtlDeleteAce 函式

  • 發行項

RtlDeleteAce 例程會從指定的訪問控制清單 (ACL) 中刪除 ACE) (存取控制專案。

語法

NTSYSAPI NTSTATUS RtlDeleteAce(
  [in, out] PACL  Acl,
  [in]      ULONG AceIndex
);

參數

[in, out] Acl

要修改之 ACL 的指標。 RtlDeleteAce 會從這個 ACL 刪除指定的 ACE。

[in] AceIndex

指定要刪除的 ACE。 值為零會對應至 ACL 中的第一個 ACE、1 到第二個 ACE，依此類推。

傳回值

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

傳回碼 Description
STATUS_INVALID_PARAMETER 其中一個參數值無效。

STATUS_INVALID_PARAMETER可能的原因包括：

  • 指定的 ACL 無效。
  • 指定的索引值超出範圍。
  • STATUS_INVALID_PARAMETER是錯誤碼。

備註

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

若要將 ACE 新增至 ACL，請使用 RtlAddAce。

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

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

規格需求

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

另請參閱

Ace

ACL

RtlAddAce

RtlCreateAcl

RtlGetAce