OBJECTS_AND_NAME_A结构（accctrl.h）

项目
11/20/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 结尾的字符串的指针。

言论

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

注意

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