BuildTrusteeWithObjectsAndSidA function (aclapi.h)

Статья
02/28/2024

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

Синтаксис

void BuildTrusteeWithObjectsAndSidA(
  [in, out]      PTRUSTEE_A       pTrustee,
  [in, optional] POBJECTS_AND_SID pObjSid,
  [in, optional] GUID             *pObjectGuid,
  [in, optional] GUID             *pInheritedObjectGuid,
  [in, optional] PSID             pSid
);

Параметры

[in, out] pTrustee

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

[in, optional] pObjSid

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

[in, optional] pObjectGuid

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

[in, optional] pInheritedObjectGuid

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

[in, optional] pSid

Указатель на структуру SID , которая идентифицирует доверенного лица.

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

None

Remarks

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

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

Примечание

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

Требования

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