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. La siguiente tabla describe los posibles valores.
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 ha reiniciado, finalizando la sesión. |
DEBUG_SESSION_HIBERNATE | El equipo de destino entró en hibernación y finalizó 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.
Comentarios
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 cargadas que exportan el método de devolución de llamada DebugExtensionNotify . El valor que pasa a las extensiones depende del valor de Status. Si Status es DEBUG_SESSION_ACTIVE, pasa DEBUG_SESSION_ACTIVE; de lo contrario, pasa DEBUG_SESSION_INACTIVE.
En el caso de 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 del evento 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 | Value |
---|---|
Plataforma de destino | Escritorio |
Encabezado | dbgeng.h (incluir Dbgeng.h) |