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

Статья
08/22/2023

Функция AuthzReportSecurityEvent создает аудит безопасности для зарегистрированного источника событий безопасности.

Аудит для категории событий доступа к объектам должен быть включен для функции AuthzReportSecurityEvent , чтобы создать аудит безопасности. Доступные типы аудита определяются в перечислении AUDIT_PARAM_TYPE .

Синтаксис

AUTHZAPI BOOL AuthzReportSecurityEvent(
  [in]           DWORD                                dwFlags,
  [in, out]      AUTHZ_SECURITY_EVENT_PROVIDER_HANDLE hEventProvider,
  [in]           DWORD                                dwAuditId,
  [in, optional] PSID                                 pUserSid,
  [in]           DWORD                                dwCount,
                 ...                                  
);

Параметры

[in] dwFlags

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

Значение	Значение
APF_AuditFailure 0x00000000	Создаются аудиты сбоев.
APF_AuditSuccess 0x00000001	Создаются аудиты успешного выполнения.

[in, out] hEventProvider

Дескриптор зарегистрированного источника событий безопасности, используемый для аудита.

[in] dwAuditId

Идентификатор аудита.

[in, optional] pUserSid

Указатель на идентификатор безопасности (SID), который будет указан в качестве источника аудита в журнале событий.

[in] dwCount

Количество пар "тип-значение" AuditParamFlag, которые отображаются в разделе аргументов переменных, который следует за этим параметром.

...

Список пар "тип-значение" AuditParamFlag, которые предоставляют дополнительные сведения о событии.

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

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

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

Требования

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

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

AuthzRegisterSecurityEventSource

AuthzReportSecurityEventFromParams

Share via