Функция AuthzInitializeObjectAccessAuditEvent2 (authz.h)

Статья
08/22/2023

Функция AuthzInitializeObjectAccessAuditEvent2 выделяет и инициализирует дескриптор AUTHZ_AUDIT_EVENT_HANDLE для использования с функцией AuthzAccessCheck .

Синтаксис

AUTHZAPI BOOL AuthzInitializeObjectAccessAuditEvent2(
  [in]  DWORD                         Flags,
  [in]  AUTHZ_AUDIT_EVENT_TYPE_HANDLE hAuditEventType,
  [in]  PWSTR                         szOperationType,
  [in]  PWSTR                         szObjectType,
  [in]  PWSTR                         szObjectName,
  [in]  PWSTR                         szAdditionalInfo,
  [in]  PWSTR                         szAdditionalInfo2,
  [out] PAUTHZ_AUDIT_EVENT_HANDLE     phAuditEvent,
  [in]  DWORD                         dwAdditionalParameterCount,
        ...                           
);

Параметры

[in] Flags

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

Значение	Значение
AUTHZ_NO_ALLOC_STRINGS	Использует указатели на переданные строки вместо выделения памяти и копирования строк. Вызывающее приложение должно гарантировать, что переданная память остается действительной во время проверок доступа.
AUTHZ_NO_FAILURE_AUDIT	Отключает создание аудита сбоев.
AUTHZ_NO_SUCCESS_AUDIT	Отключает создание аудита успешного выполнения.

[in] hAuditEventType

Зарезервировано. Этот параметр должен иметь значение NULL.

[in] szOperationType

Указатель на строку, указывающую операцию для аудита.

[in] szObjectType

Указатель на строку, указывающую тип объекта, к которому был доступ.

[in] szObjectName

Указатель на строку, указывающую имя объекта, к которому был доступ.

[in] szAdditionalInfo

Указатель на строку, определенную Resource Manager, которая содержит дополнительные сведения об аудите.

[in] szAdditionalInfo2

Указатель на строку, определенную Resource Manager, которая содержит дополнительные сведения об аудите.

[out] phAuditEvent

Указатель на возвращенный дескриптор AUTHZ_AUDIT_EVENT_HANDLE .

[in] dwAdditionalParameterCount

Необходимо задать нулевое значение.

...

Дополнительные параметры.

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

Если функция завершается успешно, она возвращает значение TRUE.

Если функция завершается сбоем, она возвращает значение FALSE. Для получения дополнительных сведений об ошибке вызовите Метод GetLastError.

Требования

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

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

AuthzAccessCheck

Базовые функции контроль доступа

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