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

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

Синтаксис

HANDLE OpenEventLogW(
  [in] LPCWSTR lpUNCServerName,
  [in] LPCWSTR lpSourceName
);

Параметры

[in] lpUNCServerName

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

[in] lpSourceName

Имя журнала.

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

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

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

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

Комментарии

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

Примеры

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

Примечание

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winbase.h (включая Windows.h)
Библиотека Advapi32.lib
DLL Advapi32.dll
Набор API ext-ms-win-advapi32-eventlog-ansi-l1-1-0 (представлено в Windows 10, версия 10.0.10240)

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

ClearEventLog

CloseEventLog

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

Ключ журнала событий

ReadEventLog

ReportEvent