OBJECTS_AND_NAME_A 结构 (accctrl.h)

项目
02/23/2024

OBJECTS_AND_NAME 结构包含一个按名称标识受信人的字符串，以及标识特定于对象的访问控制项的对象类型的附加字符串， (ACE) 。

语法

typedef struct _OBJECTS_AND_NAME_A {
  DWORD          ObjectsPresent;
  SE_OBJECT_TYPE ObjectType;
  LPSTR          ObjectTypeName;
  LPSTR          InheritedObjectTypeName;
  LPSTR          ptstrName;
} OBJECTS_AND_NAME_A, *POBJECTS_AND_NAME_A;

成员

ObjectsPresent

指示 ObjectTypeName 和 InheritedObjectTypeName 成员是否包含字符串。此参数可以是以下值的组合。

值	含义
ACE_OBJECT_TYPE_PRESENT 0x1	ObjectTypeName 成员包含一个字符串。
ACE_INHERITED_OBJECT_TYPE_PRESENT 0x2	InheritedObjectTypeName 成员包含一个字符串。

ObjectType

指定 SE_OBJECT_TYPE 枚举中的值，该值指示对象的类型。

ObjectTypeName

指向以 null 结尾的字符串的指针，该字符串标识 ACE 所应用到的对象的类型。

此字符串必须是 Active Directory 架构中的有效 LDAP 显示名称。

InheritedObjectTypeName

指向以 null 结尾的字符串的指针，该字符串标识可继承 ACE 的对象类型。

此字符串必须是 Active Directory 架构中的有效 LDAP 显示名称。

如果未在 ObjectsPresent 成员中设置ACE_INHERITED_OBJECT_TYPE_PRESENT位，则忽略 InheritedObjectTypeName 成员，并且所有类型的子对象都可以继承 ACE。否则，只有指定的对象类型才能继承 ACE。在任一情况下，继承也受 ACE_HEADER 结构中的继承标志以及针对子对象上的任何继承保护来控制。

ptstrName

指向包含受信者名称的以 null 结尾的字符串的指针。

注解

TRUSTEE 结构的 ptstrName 成员可以是指向OBJECTS_AND_NAME结构的指针。这使 SetEntriesInAcl 和 GetExplicitEntriesFromAcl 等函数能够将特定于对象的 ACE 信息存储在 EXPLICIT_ACCESS 结构的受托人成员中。

注意

accctrl.h 标头将OBJECTS_AND_NAME_定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。