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

  • Статья

Функция 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

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