Функция 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 |