Método IDebugEventCallbacksWide::SessionStatus (dbgeng.h)
El motor llama al método de devolución de llamada SessionStatus cuando se produce un cambio en la sesión del depurador.
Sintaxis
HRESULT SessionStatus(
[in] ULONG Status
);
Parámetros
[in] Status
Especifica el nuevo estado de la sesión del depurador. En la tabla siguiente se describen los valores posibles.
| Valor | Descripción |
|---|---|
| DEBUG_SESSION_ACTIVE | Se ha iniciado una sesión del depurador. |
| DEBUG_SESSION_END_SESSION_ACTIVE_TERMINATE | La sesión finalizó enviando DEBUG_END_ACTIVE_TERMINATE a EndSession. |
| DEBUG_SESSION_END_SESSION_ACTIVE_DETACH | La sesión finalizó enviando DEBUG_END_ACTIVE_DETACH a EndSession. |
| DEBUG_SESSION_END_SESSION_PASSIVE | La sesión finalizó enviando DEBUG_END_PASSIVE a EndSession. |
| DEBUG_SESSION_END | El destino se ejecutó hasta la finalización, finalizando la sesión. |
| DEBUG_SESSION_REBOOT | El equipo de destino se reinicia, finalizando la sesión. |
| DEBUG_SESSION_HIBERNATE | El equipo de destino entró en hibernación, finalizando la sesión. |
| DEBUG_SESSION_FAILURE | El motor no pudo continuar la sesión. |
Valor devuelto
El motor omite el valor devuelto de este método.
Observaciones
El motor solo llama a este método si la marca DEBUG_EVENT_SESSION_STATUS está establecida en la máscara devuelta por IDebugEventCallbacksWide::GetInterestMask.
Una vez que el motor haya notificado todas las devoluciones de llamada de eventos del cambio en el estado de la sesión, también notificará a las extensiones de cargadas que exportan el método de devolución de llamada de DebugExtensionNotify. El valor que pasa a las extensiones depende del valor de Status. Si estado es DEBUG_SESSION_ACTIVE, pasa DEBUG_SESSION_ACTIVE; de lo contrario, pasa DEBUG_SESSION_INACTIVE.
En el caso DEBUG_SESSION_ACTIVE, el motor sigue la notificación de cambio de sesión del depurador con una notificación de cambio de estado de destino llamando a IDebugEventCallbacksWide::ChangeDebuggeeState en las devoluciones de llamada de eventos y pasando DEBUG_CDS_ALL en el parámetro Flags. En todos los demás casos, el motor precede a esta notificación con una notificación de cambio de estado del motor llamando a IDebugEventCallbacksWide::ChangeEngineState en las devoluciones de llamada de eventos y pasando DEBUG_CES_EXECUTION_STATUS en el parámetro Flags.
Para obtener más información sobre el control de eventos, consulte Supervisión de eventos. Para obtener información sobre las sesiones del depurador, vea Depuración de sesión y modelo de ejecución.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |