Функция OpenEventLogA (winbase.h)
Открывает дескриптор для указанного журнала событий.
Синтаксис
HANDLE OpenEventLogA(
[in] LPCSTR lpUNCServerName,
[in] LPCSTR 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) |