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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] lpUNCServerName

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

[in] lpSourceName

Имя журнала.

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

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

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

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

Замечания

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

Примеры

Пример см. в разделе запросы сведений о событиях.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winbase.h (включая Windows.h)
библиотеки	Advapi32.lib
DLL	Advapi32.dll
набор API	ext-ms-win-advapi32-eventlog-ansi-l1-1-0 (представлено в Windows 10 версии 10.0.10240)