RtlDeleteAce 函数 (ntifs.h)

RtlDeleteAce 例程从指定的访问控制列表 (ACE) 中删除访问控制项， (ACL) 。

语法

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

参数

[in, out] Acl

指向要修改的 ACL 的指针。 RtlDeleteAce 从此 ACL 中删除指定的 ACE。

[in] AceIndex

指定要删除的 ACE。 值 0 对应于 ACL 中的第一个 ACE，1 对应于第二个 ACE，依此而论。

返回值

RtlDeleteAce 返回STATUS_SUCCESS或相应的 NTSTATUS 值，如以下值之一：

返回代码	说明
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
目标平台	通用
标头	ntifs.h (包括 Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

另请参阅

Ace

ACL

RtlAddAce

RtlCreateAcl

RtlGetAce