Método IDebugControl3::GetNumberEvents (dbgeng.h)
El método GetNumberEvents devuelve el número de eventos de para el destino actual, si se fija el número de eventos.
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, Eventos se establecerá en el número de eventos disponibles. De lo contrario, eventos se establecerá en uno.
Valor devuelto
Este método también puede devolver valores de error. Consulte valores devueltos para obtener más información.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente y Eventos contiene el número total de eventos posibles para el destino. |
|
El método se realizó correctamente, pero Eventos contiene solo el número total de eventos posibles en el momento 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. |
Observaciones
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 Eventos en el número de eventos almacenados y devuelve S_OK.
Los destinos en directo generan eventos dinámicamente y no necesariamente tienen un conjunto conocido de eventos. Si el destino actual es un destino activo con un número sin restricciones de eventos, este método establece Eventos al número de eventos disponibles actualmente y devuelve S_FALSE.
Para obtener más información, vea el tema Información de eventos.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |