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

Статья
02/23/2024

Функция AuthzInitializeObjectAccessAuditEvent инициализирует аудит объекта.

Синтаксис

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

Параметры

[in] Flags

Изменяет аудит. Этот параметр может принимать одно из указанных ниже значений.

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

[in] hAuditEventType

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

[in] szOperationType

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

[in] szObjectType

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

[in] szObjectName

Строка указывает имя объекта, к которой осуществляется доступ.

[in] szAdditionalInfo

Строка, определяемая Resource Manager, для получения дополнительных сведений об аудите.

[out] phAuditEvent

Указатель, получающий структуру AUTHZ_AUDIT_EVENT_HANDLE .

[in] dwAdditionalParameterCount

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

...

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

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

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

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

Требования

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

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

AuthzAccessCheck

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

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