Функция EvtNextChannelPath (winevt.h)
Возвращает имя канала из перечислителя.
Синтаксис
BOOL EvtNextChannelPath(
[in] EVT_HANDLE ChannelEnum,
[in] DWORD ChannelPathBufferSize,
[in] LPWSTR ChannelPathBuffer,
[out] PDWORD ChannelPathBufferUsed
);
Параметры
[in] ChannelEnum
Дескриптор перечислителя, возвращаемый функцией EvtOpenChannelEnum .
[in] ChannelPathBufferSize
Размер буфера ChannelPathBuffer в символах.
[in] ChannelPathBuffer
Выделенный вызывающим объектом буфер, который получит имя канала. Для этого параметра можно задать значение NULL , чтобы определить требуемый размер буфера.
[out] ChannelPathBufferUsed
Размер буфера, выделенного вызывающей функцией, или требуемый размер буфера в случае сбоя функции с ERROR_INSUFFICIENT_BUFFER.
Возвращаемое значение
| Возвращаемый код/значение | Описание |
|---|---|
|
Функция выполнена успешно. |
|
Сбой функции. Чтобы получить код ошибки, вызовите функцию GetLastError . |
Комментарии
Вызывайте эту функцию в цикле, пока функция не вернет значение FALSE , а код ошибки не будет ERROR_NO_MORE_ITEMS.
Примеры
Пример использования этой функции см. в разделе Получение и настройка свойств конфигурации канала.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | winevt.h |
| Библиотека | Wevtapi.lib |
| DLL | Wevtapi.dll |