Функция BuildTrusteeWithObjectsAndNameA (aclapi.h)

Статья
11/20/2024

Функция BuildTrusteeWithObjectsAndName инициализирует структуру TRUSTEE с данными элемента управления доступом (ACE) и инициализирует остальные элементы структуры по умолчанию. Вызывающий объект также указывает имя доверенного лица.

Синтаксис

void BuildTrusteeWithObjectsAndNameA(
  [in, out]      PTRUSTEE_A          pTrustee,
  [in, optional] POBJECTS_AND_NAME_A pObjName,
  [in, optional] SE_OBJECT_TYPE      ObjectType,
  [in, optional] LPSTR               ObjectTypeName,
  [in, optional] LPSTR               InheritedObjectTypeName,
  [in, optional] LPSTR               Name
);

Параметры

[in, out] pTrustee

Указатель на структуру TRUSTEE, которая будет инициализирована этой функцией. Если значение этого параметра null или недопустимый указатель, результаты не определены.

[in, optional] pObjName

Указатель на структуру OBJECTS_AND_NAME, содержащую сведения о доверенном лице и защищаемом объекте.

[in, optional] ObjectType

Указатель на перечисление SE_OBJECT_TYPE, содержащее сведения о типе защищаемого объекта.

[in, optional] ObjectTypeName

Указатель на строку, указывающую имя, соответствующее GUID ObjectType, добавляемой в структуру TRUSTEE, возвращаемую в параметре pTrustee. Эта функция определяет GUID ObjectType, соответствующий этому имени.

[in, optional] InheritedObjectTypeName

Указатель на строку, указывающую имя, соответствующее GUID InheritedObjectType, который необходимо добавить в структуру TRUSTEE, возвращенную в параметре pTrustee . Эта функция определяет GUID InheritedObjectType, соответствующий этому имени.

[in, optional] Name

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

Возвращаемое значение

Никакой

Замечания

Эта функция не выделяет память для структур TRUSTEE и OBJECTS_AND_NAME структур.

Дополнительные сведения об acES для определенных объектов см. вдля определенных объектов.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	aclapi.h
библиотеки	Advapi32.lib
DLL	Advapi32.dll