ACCESS_DENIED_OBJECT_ACE 结构 (winnt.h)
ACCESS_DENIED_OBJECT_ACE结构定义访问控制项 (ACE) ,该条目控制拒绝访问对象、属性集或属性。 ACE 包含一组访问权限、一个标识对象类型的 GUID 和一个 安全标识符 (SID) ,用于标识系统将拒绝其访问 的受托人 。 ACE 还包含一个 GUID 和一组标志,用于控制子对象继承 ACE。
语法
typedef struct _ACCESS_DENIED_OBJECT_ACE {
ACE_HEADER Header;
ACCESS_MASK Mask;
DWORD Flags;
GUID ObjectType;
GUID InheritedObjectType;
DWORD SidStart;
} ACCESS_DENIED_OBJECT_ACE, *PACCESS_DENIED_OBJECT_ACE;
成员
Header
ACE_HEADER 结构,用于指定 ACE 的大小和类型。 它包含控制子对象继承 ACE 的标志。 ACE_HEADER 结构的 AceType 成员应设置为 ACCESS_DENIED_OBJECT_ACE_TYPE,AceSize 成员应设置为为ACCESS_DENIED_OBJECT_ACE结构分配的字节总数。
Mask
一个ACCESS_MASK,指定系统将拒绝给受托人的访问权限。
Flags
一组位标志,指示是否存在 ObjectType 和 InheritedObjectType 成员。 此参数可使用以下一个或多个值。
ObjectType
仅当 在 Flags 成员中设置了ACE_OBJECT_TYPE_PRESENT位时,此成员才存在。 否则, InheritedObjectType 成员紧跟在 Flags 成员之后。
如果此成员存在,则它是标识属性集、属性、扩展权限或子对象的类型的 GUID 结构。 此 GUID 的用途取决于 掩码 成员中指定的访问权限。
InheritedObjectType
仅当在 Flags 成员中设置了ACE_INHERITED_OBJECT_TYPE_PRESENT位时,此成员才存在。
如果此成员存在,则它是一个 GUID 结构,用于标识可继承 ACE 的子对象的类型。 继承也由 ACE_HEADER中的继承标志以及针对子对象上放置的继承的任何保护进行控制。
此成员的偏移量可能会有所不同。 如果 Flags 成员不包含 ACE_OBJECT_TYPE_PRESENT 标志, 则 InheritedObjectType 成员从 ObjectType 成员指定的偏移量开始。
SidStart
指定 SID 的第一个 DWORD ,用于标识拒绝其访问权限的 受托人 。 SID 的剩余字节存储在 SidStart 成员之后的连续内存中。 此 SID 可以追加应用程序数据。
此成员的偏移量可能会有所不同。 如果 Flags 成员为零, 则 SidStart 成员从 ObjectType 成员指定的偏移量开始。 如果 Flags 仅包含一个标志 (ACE_OBJECT_TYPE_PRESENT或ACE_INHERITED_OBJECT_TYPE_PRESENT) , 则 SidStart 成员从 InheritedObjectType 成员指定的偏移量开始。
注解
如果未指定 ObjectType 和 InheritedObjectTypeGUID , 则ACCESS_DENIED_OBJECT_ACE 结构与 ACCESS_DENIED_ACE 结构使用的语义相同。 在这种情况下,请使用 ACCESS_DENIED_ACE 结构,因为它更小、更高效。
包含 ACCESS_DENIED_OBJECT_ACE 的 ACL 必须在其 ACL 标头中指定ACL_REVISION_DS修订号。
掩码成员指定的访问权限将拒绝给任何具有与 SidStart 成员中存储的 SID 匹配的已启用 SID 的受托人。
可以通过调用 AddAccessDeniedObjectAce 函数,在访问控制列表中 (ACL) 创建ACCESS_DENIED_OBJECT_ACE结构。 使用此函数时,将自动分配用于容纳 ObjectType 和 InheritedObjectType 成员中的 GUID 结构(如果其中一个或两个都存在)以及容纳受托人的 SID 所需的正确内存量。 此外,还会自动设置 Header.AceType 和 Header.AceSize 成员的值。 在 ACL 外部创建 ACCESS_DENIED_OBJECT_ACE 结构时,必须分配足够的内存来容纳 ObjectType 和 InheritedObjectType 成员中的 GUID 结构(如果其中一个或两个成员存在),并且要容纳 SidStart 成员中受托人的完整 SID 和后续连续内存。 此外,应用程序必须显式设置 Header.AceType 和 Header.AceSize 成员的值。
要求
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
标头 | winnt.h (包括 Windows.h) |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈