структура OBJECTS_AND_NAME_A (accctrl.h)

Статья
02/26/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

Указатель на строку, завершающуюся нулевым значением, идентифицирующий тип объекта, к которому применяется ACE.

Эта строка должна быть допустимым отображаемым именем LDAP в схеме Active Directory.

InheritedObjectTypeName

Указатель на строку, завершающуюся значением NULL, которая определяет тип объекта, который может наследовать ACE.

Эта строка должна быть допустимым отображаемым именем LDAP в схеме Active Directory.

Если бит ACE_INHERITED_OBJECT_TYPE_PRESENT не задан в элементе ObjectsPresent , элемент InheritedObjectTypeName игнорируется, и все типы дочерних объектов могут наследовать ACE. В противном случае только указанный тип объекта может наследовать ACE. В любом случае наследование также управляется флагами наследования в структуре ACE_HEADER , а также любой защитой от наследования дочерних объектов.

ptstrName

Указатель на строку, завершающуюся нулевым значением, которая содержит имя доверенного лица.

Элемент ptstrName структуры TRUSTEE может быть указателем на OBJECTS_AND_NAME структуру. Это позволяет таким функциям, как SetEntriesInAcl и GetExplicitEntriesFromAcl , хранить сведения об ACE для конкретных объектов в члене доверенноголица структуры EXPLICIT_ACCESS .

Примечание

Заголовок accctrl.h определяет OBJECTS_AND_NAME_ в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	accctrl.h