структура AUTHZ_ACCESS_REPLY (authz.h)

Статья
08/22/2023

Структура AUTHZ_ACCESS_REPLY определяет ответ проверка доступа.

Синтаксис

typedef struct _AUTHZ_ACCESS_REPLY {
  DWORD        ResultListLength;
  PACCESS_MASK GrantedAccessMask;
  PDWORD       SaclEvaluationResults;
  PDWORD       Error;
} AUTHZ_ACCESS_REPLY, *PAUTHZ_ACCESS_REPLY;

Члены

ResultListLength

Количество элементов в массивах GrantedAccessMask, SaclEvaluationResults и Error . Это число соответствует количеству записей в структуре списка типов объектов, используемой в проверка доступа. Если для представления объекта не используется ни один тип объекта, задайте для свойства ResultListLength значение one.

GrantedAccessMask

Массив предоставленных масок доступа. Память для этого массива выделяется приложением перед вызовом AccessCheck.

SaclEvaluationResults

Массив результатов оценки списка управления доступом системы (SACL). Память для этого массива выделяется приложением перед вызовом AccessCheck. Оценка SACL будет выполняться только при запросе аудита. Каждый элемент этого элемента может иметь одно из следующих значений.

Значение	Значение
AUTHZ_GENERATE_SUCCESS_AUDIT 0x1	Сообщение аудита, указывающее на успешное создание.
AUTHZ_GENERATE_FAILURE_AUDIT 0x2	Сообщение аудита, указывающее на сбой.

Error

Массив результатов для каждого элемента массива. Память для этого массива выделяется приложением перед вызовом AccessCheck.

В следующей таблице перечислены возможные значения ошибок.

Значение	Значение
ERROR_SUCCESS	Предоставляются все биты доступа, не включая MAXIMUM_ALLOWED, а член GrantedAccessMask не равен нулю.
ERROR_PRIVILEGE_NOT_HELD	DesiredAccess включает ACCESS_SYSTEM_SECURITY, а у клиента нет SeSecurityPrivilege.
ERROR_ACCESS_DENIED	Включает в себя каждое из следующих компонентов: Запрошенные биты не предоставляются. Значение MaximumAllowed bit включено, а предоставленный доступ равен нулю. Значение DesiredAccess равно нулю.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	authz.h
Распространяемые компоненты	Пакет средств администрирования Windows Server 2003 в Windows XP

См. также раздел

AccessCheck

Поделиться через