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

Статья
11/20/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, описывающую GUID ObjectType, добавляемую в структуру TRUSTEE.

[in, optional] pInheritedObjectGuid

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

[in, optional] pSid

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

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

Никакой

Замечания

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

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

Заметка

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

Требования

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