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

La méthode de rappel SessionStatus est appelée par le moteur lorsqu’une modification se produit dans la session du débogueur.

Syntaxe

HRESULT SessionStatus(
  [in] ULONG Status
);

Paramètres

[in] Status

Spécifie la nouvelle status de la session de débogueur. Le tableau suivant décrit les valeurs possibles.

Valeur	Description
DEBUG_SESSION_ACTIVE	Une session de débogueur a démarré.
DEBUG_SESSION_END_SESSION_ACTIVE_TERMINATE	La session a été terminée par l’envoi de DEBUG_END_ACTIVE_TERMINATE à EndSession.
DEBUG_SESSION_END_SESSION_ACTIVE_DETACH	La session a été terminée par l’envoi de DEBUG_END_ACTIVE_DETACH à EndSession.
DEBUG_SESSION_END_SESSION_PASSIVE	La session a été terminée par l’envoi de DEBUG_END_PASSIVE à EndSession.
DEBUG_SESSION_END	La cible s’est exécutée jusqu’à l’achèvement, mettant fin à la session.
DEBUG_SESSION_REBOOT	L’ordinateur cible a redémarré, mettant fin à la session.
DEBUG_SESSION_HIBERNATE	L’ordinateur cible est entré en veille prolongée, mettant fin à la session.
DEBUG_SESSION_FAILURE	Le moteur n’a pas pu continuer la session.

Valeur retournée

La valeur de retour de cette méthode est ignorée par le moteur.

Remarques

Cette méthode n’est appelée par le moteur que si l’indicateur DEBUG_EVENT_SESSION_STATUS est défini dans le masque retourné par IDebugEventCallbacks ::GetInterestMask.

Une fois que le moteur a averti tous les rappels d’événements de la modification apportée au status de session, il notifie également toutes les extensions chargées qui exportent la méthode de rappel DebugExtensionNotify. La valeur qu’il transmet aux extensions dépend de la valeur État. Si Status est DEBUG_SESSION_ACTIVE, il passe DEBUG_SESSION_ACTIVE ; sinon, il passe DEBUG_SESSION_INACTIVE.

Dans le cas DEBUG_SESSION_ACTIVE, le moteur suit la notification de changement de session du débogueur avec une notification de changement d’état cible en appelant IDebugEventCallbacks ::ChangeDebuggeeState sur les rappels d’événements et en passant DEBUG_CDS_ALL dans le paramètre Flags . Dans tous les autres cas, le moteur précède cette notification avec une notification de changement d’état du moteur en appelant IDebugEventCallbacks ::ChangeEngineState sur les rappels d’événements et en passant DEBUG_CES_EXECUTION_STATUS dans le paramètre Flags .

Pour plus d’informations sur la gestion des événements, consultez Surveillance des événements. Pour plus d’informations sur les sessions de débogueur, consultez Débogage de session et modèle d’exécution.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)