GetExplicitEntriesFromAcl

【勇芳软件工作室】汉化HomePreviousNext

[New - Windows NT]

GetExplicitEntriesFromAcl函数检索描述访问控制列表(ACL)中访问控制条目(ACE)的EXPLICIT_ACCESS结构的数组。

DWORD GetExplicitEntriesFromAcl(

PACL 【ACL】,//指向要从中获取条目的ACL的指针
PULONG 【pcCountOfExplicitEntries】,//接收列表中的条目数
PEXPLICIT_ACCESS * 【pListOfExplicitEntries】//接收指向列表的指针
); 

参数

【ACL】

指向获取ACE信息的ACL。

【pcCountOfExplicitEntries】

指向【pListOfExplicitEntries数组。】中返回的EXPLICIT_ACCESS结构数的变量的指针

【pListOfExplicitEntries】

指向接收到描述ACL中的ACE的EXPLICIT_ACCESS结构数组的指针的变量的指针。如果函数成功,则必须调用LocalFree函数来释放返回的缓冲区。

返回值

如果函数成功,则返回值为ERROR_SUCCESS。

如果函数失败,返回值是在WINERROR.H中定义的非零错误代码。

备注

数组EXPLICIT_ACCESS结构中的每个条目都描述了来自ACE受托人的访问控制信息。受托人可以是用户,组或程序(如Windows NT服务)。

每个EXPLICIT_ACCESS结构指定一组访问权限和访问模式标志,指示ACE是否允许,拒绝或审计指定的权限。

对于自由裁量ACL(DACL),访问模式标志可以是ACCESS_MODE枚举中的以下值之一。

含义
SET_ACCESS表示受信任者的访问允许ACE允许指定的访问权限。
DENY_ACCESS表示受信任人的访问被拒绝的ACE拒绝指定的访问权限。

对于系统ACL(SACL),访问模式标志可以是来自ACCESS_MODE枚举的以下值的组合。

含义
SET_AUDIT_SUCCESS表示受信任人的系统审核ACE会生成审核消息,以成功尝试使用指定的访问权限。
SET_AUDIT_FAILURE表示受信任人的系统审核ACE为尝试使用指定访问权限的尝试生成审核消息。

也可以看看

ACCESS_ALLOWED_ACE, ACCESS_DENIED_ACE, ACE, ACL, EXPLICIT_ACCESS, LocalFree, SYSTEM_AUDIT_ACE