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

Функция RegisterEventSourceA (winbase.h)

Извлекает зарегистрированный дескриптор в указанный журнал событий.

Синтаксис

HANDLE RegisterEventSourceA(
  [in] LPCSTR lpUNCServerName,
  [in] LPCSTR lpSourceName
);

Параметры

[in] lpUNCServerName

Имя универсального соглашения об именовании (UNC) удаленного сервера, на котором должна выполняться эта операция. Если этот параметр NULL, используется локальный компьютер.

[in] lpSourceName

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

Примечание Эта строка не должна содержать символы, запрещенные в XML-атрибутах, за исключением последовательностей ESCAPE-XML, таких как < &gl.
 

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

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

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

Функция возвращает ERROR_ACCESS_DENIED, если lpSourceName указывает журнал событий Security.

Замечания

Если имя источника не найдено, служба ведения журнала событий использует журнал приложения. Хотя события будут сообщаться, события не будут включать описания, так как нет файлов сообщений и категорий для поиска описаний, связанных с идентификаторами событий.

Чтобы закрыть дескриптор журнала событий, используйте функцию DeregisterEventSource.

Примеры

Пример см. в разделе Отчетов о событии.

Заметка

Заголовок winbase.h определяет RegisterEventSource в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер Windows 2000 Server [только классические приложения]
целевая платформа Виндоус
заголовка winbase.h (включая Windows.h)
библиотеки Advapi32.lib
DLL Advapi32.dll

См. также

DeregisterEventSource

Функции ведения журнала событий

источников событий

ReportEvent

  • Last updated on