Função EvtNextChannelPath (winevt.h)

Obtém um nome de canal do enumerador.

Sintaxe

BOOL EvtNextChannelPath(
  [in]  EVT_HANDLE ChannelEnum,
  [in]  DWORD      ChannelPathBufferSize,
  [in]  LPWSTR     ChannelPathBuffer,
  [out] PDWORD     ChannelPathBufferUsed
);

Parâmetros

[in] ChannelEnum

Um identificador para o enumerador que a função EvtOpenChannelEnum retorna.

[in] ChannelPathBufferSize

O tamanho do buffer ChannelPathBuffer , em caracteres.

[in] ChannelPathBuffer

Um buffer alocado pelo chamador que receberá o nome do canal. Você pode definir esse parâmetro como NULL para determinar o tamanho do buffer necessário.

[out] ChannelPathBufferUsed

O tamanho, em caracteres, do buffer alocado pelo chamador usado pela função ou o tamanho do buffer necessário se a função falhar com ERROR_INSUFFICIENT_BUFFER.

Retornar valor

Comentários

Chame essa função em um loop até que a função retorne FALSE e o código de erro seja ERROR_NO_MORE_ITEMS.

Exemplos

Para obter um exemplo que mostra como usar essa função, consulte Obtendo e definindo as propriedades de configuração de um canal.

Requisitos

Confira também

EvtOpenChannelEnum