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


Функция 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 указывает журнал событий безопасности .

Комментарии

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

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

Примеры

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

Примечание

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winbase.h (включая Windows.h)
Библиотека Advapi32.lib
DLL Advapi32.dll

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

Отмена регистрацииEventSource

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

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

ReportEvent