Compartilhar via

Função EvtNextChannelPath (winevt.h)

  • Artigo

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

Valor/código retornado Descrição
TRUE
 A função foi bem-sucedida.
FALSE
 Falha na função. Para obter o código de erro, chame a função GetLastError .

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

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winevt.h
Biblioteca Wevtapi.lib
DLL Wevtapi.dll

Confira também

EvtOpenChannelEnum