(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 |