Функция EvtOpenChannelEnum (winevt.h)
Возвращает дескриптор, используемый для перечисления списка каналов, зарегистрированных на компьютере.
Синтаксис
EVT_HANDLE EvtOpenChannelEnum(
[in] EVT_HANDLE Session,
[in] DWORD Flags
);
Параметры
[in] Session
Удаленный дескриптор сеанса, который возвращает функция EvtOpenSession . Задайте значение NULL , чтобы перечислить каналы на локальном компьютере.
[in] Flags
Зарезервировано. Должен равняться нулю.
Возвращаемое значение
В случае успешного выполнения функция возвращает дескриптор в список имен каналов, зарегистрированных на компьютере; в противном случае — NULL. Если значение РАВНО NULL, вызовите функцию GetLastError , чтобы получить код ошибки.
Комментарии
Перечисление включает все каналы, зарегистрированные поставщиками на определенном компьютере. Чтобы перечислить имена каналов, вызовите функцию EvtNextChannelPath в цикле. Имена отсортированы в алфавитном порядке.
По завершении необходимо вызвать функцию EvtClose , чтобы закрыть дескриптор перечислителя.
Примеры
Пример использования этой функции см. в разделе Получение и настройка свойств конфигурации канала.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winevt.h |
| Библиотека | Wevtapi.lib |
| DLL | Wevtapi.dll |