Función EvtNext (winevt.h)
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 |
|---|---|
|
La función se ha realizado correctamente. |
|
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 |