Share via

Función EvtNext (winevt.h)

  • Artículo

Obtiene el siguiente evento de los resultados de la consulta o suscripción.

Sintaxis

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

Identificador de un conjunto de resultados de consulta o suscripción que devuelve la función EvtQuery o la función EvtSubscribe .

[in] EventsSize

Número de elementos de la matriz EventArray . La función intentará recuperar este número de elementos del conjunto de resultados.

[in] Events

Puntero a una matriz de identificadores que se establecerá en los identificadores para los eventos del conjunto de resultados.

[in] Timeout

Número de milisegundos que está dispuesto a esperar un resultado. Establezca en INFINITE para indicar que no hay ningún valor de tiempo de espera. Si expira el tiempo de espera, el último error se establece en ERROR_TIMEOUT.

[in] Flags

Reservado. Debe ser cero.

[out] Returned

Número de identificadores de la matriz que se establecen.

Valor devuelto

Código o valor devuelto Descripción
TRUE
 La función se ha realizado correctamente.
FALSE
 Error en la función. Para obtener el código de error, llame a la función GetLastError .

Comentarios

Llame a esta función en un bucle hasta que la función devuelva FALSE y el código de error se ERROR_NO_MORE_ITEMS.

Para cada evento que recupere, puede llamar a las funciones EvtCreateRenderContext y EvtRender para representar el evento.

Debe llamar a EvtClose en cada identificador de evento que reciba.

Ejemplos

Para ver un ejemplo que muestra cómo usar esta función, consulte Consulta de eventos y suscripción a eventos.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winevt.h
Library Wevtapi.lib
Archivo DLL Wevtapi.dll

Consulte también

EvtQuery

EvtSeek

EvtSubscribe