Função EvtNext (winevt.h)

Obtém o próximo evento dos resultados da consulta ou da assinatura.

Sintaxe

BOOL EvtNext(
  [in]  EVT_HANDLE  ResultSet,
  [in]  DWORD       EventsSize,
  [in]  PEVT_HANDLE Events,
  [in]  DWORD       Timeout,
  [in]  DWORD       Flags,
  [out] PDWORD      Returned
);

Parâmetros

[in] ResultSet

O identificador para um conjunto de resultados de consulta ou assinatura que a função EvtQuery ou a função EvtSubscribe retorna.

[in] EventsSize

O número de elementos na matriz EventArray . A função tentará recuperar esse número de elementos do conjunto de resultados.

[in] Events

Um ponteiro para uma matriz de identificadores que serão definidos para os identificadores para os eventos do conjunto de resultados.

[in] Timeout

O número de milissegundos que você está disposto a esperar por um resultado. Defina como INFINITE para indicar nenhum valor de tempo limite. Se o tempo limite expirar, o último erro será definido como ERROR_TIMEOUT.

[in] Flags

Reservado. Deve ser zero.

[out] Returned

O número de identificadores na matriz definida.

Valor retornado

Valor/código retornado	Descrição
TRUE	A função foi bem-sucedida.
FALSE	A função falhou. 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.

Para cada evento recuperado, você pode chamar as funções EvtCreateRenderContext e EvtRender para renderizar o evento.

Você deve chamar EvtClose em cada identificador de evento recebido.

Exemplos

Para obter um exemplo que mostra como usar essa função, consulte Consultando eventos e assinando eventos.

Requisitos

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

EvtQuery

EvtSeek

EvtSubscribe