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

Статья
08/27/2023

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

Синтаксис

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

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