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

Статья
11/20/2024

Функция BuildTrusteeWithName инициализирует структуру TRUSTEE. Вызывающий указывает имя доверенного лица. Функция задает другие члены структуры значениям по умолчанию.

Синтаксис

void BuildTrusteeWithNameA(
  [in, out]      PTRUSTEE_A pTrustee,
  [in, optional] LPSTR      pName
);

Параметры

[in, out] pTrustee

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

[in, optional] pName

Указатель на строку, завершающую значение NULL, содержащую имя доверенного лица для ptstrName члена структуры TRUSTEE. Функция BuildTrusteeWithName задает другие члены структуры TRUSTEE, как показано ниже.

Ценность	Значение
pMultipleTrustee	НЕДЕЙСТВИТЕЛЬНЫЙ
MultipleTrusteeOperation	NO_MULTIPLE_TRUSTEE
Доверенное	TRUSTEE_IS_NAME
TrusteeType	TRUSTEE_IS_UNKNOWN

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

Никакой

Замечания

Заметка

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

Требования

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