BuildTrusteeWithObjectsAndSidA function (aclapi.h)
Функция 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 |
См. также раздел
Базовые функции контроль доступа