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

Функция AuthzRegisterSecurityEventSource регистрирует источник событий безопасности в локальном центре безопасности (LSA).

Синтаксис

AUTHZAPI BOOL AuthzRegisterSecurityEventSource(
  [in]  DWORD                                 dwFlags,
  [in]  PCWSTR                                szEventSourceName,
  [out] PAUTHZ_SECURITY_EVENT_PROVIDER_HANDLE phEventProvider
);

Параметры

[in] dwFlags

Этот параметр зарезервирован для использования в будущем. Задайте для этого параметра нулевое значение.

[in] szEventSourceName

Указатель на имя источника событий безопасности для регистрации.

[out] phEventProvider

Указатель на дескриптор зарегистрированного источника событий безопасности.

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

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

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

Комментарии

Эта функция проверяет параметр szEventSourceName и настраивает соответствующие структуры и подключения RPC к событиям журнала с таким именем источника. Проверка выполняется базовым вызовом API LSA.

API LSA проверяет следующее:

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

Требования

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

AuthzUnregisterSecurityEventSource