структура 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.

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

InheritedObjectTypeName

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

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

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

ptstrName

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

Замечания

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
заголовка	accctrl.h