Функция EvtOpenLog (winevt.h)

Получает дескриптор для файла канала или журнала, который затем можно использовать для получения сведений о канале или файле журнала.

Синтаксис

EVT_HANDLE EvtOpenLog(
  [in] EVT_HANDLE Session,
  [in] LPCWSTR    Path,
  [in] DWORD      Flags
);

Параметры

[in] Session

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

[in] Path

Имя канала или полный путь к экспортируемом файлу журнала.

[in] Flags

Флаг, определяющий, указывает ли параметр Path на файл журнала или канал. Возможные значения см. в перечислении EVT_OPEN_LOG_FLAGS .

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

В случае успешного выполнения функция возвращает дескриптор в файл или канал; в противном случае — NULL. Если значение РАВНО NULL, вызовите функцию GetLastError , чтобы получить код ошибки.

Комментарии

Относительные пути и переменные среды нельзя использовать при указании файла. Для поиска файла можно использовать UNC-путь. Перед вызовами API необходимо выполнить любое расширение относительного пути и переменной среды.

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

Требования

Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	winevt.h
Библиотека	Wevtapi.lib
DLL	Wevtapi.dll

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

EvtClearLog

EvtExportLog

EvtGetLogInfo