Método IDebugControl3::GetNumberEvents (dbgeng.h)

Artículo
08/07/2023

El método GetNumberEvents devuelve el número de eventos para el destino actual, si el número de eventos es fijo.

Sintaxis

HRESULT GetNumberEvents(
  [out] PULONG Events
);

Parámetros

[out] Events

Recibe el número de eventos almacenados en el destino. Si el destino ofrece varios eventos, los eventos se establecerán en el número de eventos disponibles. De lo contrario, los eventos se establecerán en uno.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	El método se realizó correctamente y Events contiene el número total de eventos posibles para el destino.
S_FALSE	El método se realizó correctamente, pero Events contiene solo el número total de eventos posibles en la hora actual. Los destinos que admiten la ejecución de variables pueden tener diferentes conjuntos de eventos disponibles en distintos puntos durante la ejecución del destino.

Comentarios

Los archivos de volcado de memoria contienen una lista estática de eventos; cada evento representa una instantánea del destino en un momento dado. Si el destino actual es un archivo de volcado de memoria, este método establece Events en el número de eventos almacenados y devuelve S_OK.

Los destinos en directo generan eventos dinámicamente y no tienen necesariamente un conjunto conocido de eventos. Si el destino actual es un destino activo con un número de eventos sin restricciones, este método establece Events en el número de eventos disponibles actualmente y devuelve S_FALSE.

Para obtener más información, vea el tema Información de eventos.