Compartir a través de

Método IDebugEventCallbacks::SessionStatus (dbgeng.h)

  • Artículo

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 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.

Comentarios

El motor llama a este método solo si la marca DEBUG_EVENT_SESSION_STATUS se establece en la máscara devuelta por IDebugEventCallbacks::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 DEBUG_SESSION_ACTIVE caso, 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 IDebugEventCallbacks::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 IDebugEventCallbacks::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 cómo controlar eventos, consulte Supervisión de eventos. Para obtener información sobre las sesiones del depurador, consulte Depuración del modelo de sesión y ejecución.

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (include Dbgeng.h)