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

Статья
08/22/2023

Функция 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

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

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

None

Remarks

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

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

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	aclapi.h
Библиотека	Advapi32.lib
DLL	Advapi32.dll