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 |