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

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