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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in, out] pTrustee

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

[in, optional] pSid

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

Ценность	Значение
pMultipleTrustee	NULL
MultipleTrusteeOperation	NO_MULTIPLE_TRUSTEE
Доверенное	TRUSTEE_IS_SID
TrusteeType	TRUSTEE_IS_UNKNOWN

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

Никакой

Замечания

Заметка

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

Требования

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