Поделиться через


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

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

Возвращаемый код/значение Описание
TRUE
Функция выполнена успешно.
FALSE
Сбой функции. Чтобы получить код ошибки, вызовите функцию GetLastError .

Комментарии

Вызывайте эту функцию в цикле, пока функция не вернет значение FALSE , а код ошибки не будет ERROR_NO_MORE_ITEMS.

Примеры

Пример использования этой функции см. в разделе Получение и настройка свойств конфигурации канала.

Требования

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

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

EvtOpenChannelEnum