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

Статья
02/26/2024

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

Синтаксис

void BuildTrusteeWithSidA(
  [in, out]      PTRUSTEE_A pTrustee,
  [in, optional] PSID       pSid
);

Параметры

[in, out] pTrustee

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

[in, optional] pSid

Указатель на структуру sid , которая идентифицирует доверенное лицо. Функция BuildTrusteeWithSid назначает этот указатель на элемент ptstrName структуры TRUSTEE . Функция задает другие члены структуры TRUSTEE следующим образом.

Значение	Значение
pMultipleTrustee	NULL
MultipleTrusteeOperation	NO_MULTIPLE_TRUSTEE
Форма доверенного лица	TRUSTEE_IS_SID
TrusteeType	TRUSTEE_IS_UNKNOWN

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

None

Remarks

Примечание

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

Требования

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