IDebugEventCallbacksWide::SessionStatus-Methode (dbgeng.h)

Die SessionStatus- Rückrufmethode wird vom Modul aufgerufen, wenn eine Änderung in der Debuggersitzung erfolgt.

Syntax

HRESULT SessionStatus(
  [in] ULONG Status
);

Parameter

[in] Status

Gibt den neuen Status der Debuggersitzung an. In der folgenden Tabelle werden die möglichen Werte beschrieben.

Wert	Beschreibung
DEBUG_SESSION_ACTIVE	Eine Debuggersitzung wurde gestartet.
DEBUG_SESSION_END_SESSION_ACTIVE_TERMINATE	Die Sitzung wurde beendet, indem DEBUG_END_ACTIVE_TERMINATE an EndSessiongesendet wurde.
DEBUG_SESSION_END_SESSION_ACTIVE_DETACH	Die Sitzung wurde beendet, indem DEBUG_END_ACTIVE_DETACH an EndSession-gesendet wurde.
DEBUG_SESSION_END_SESSION_PASSIVE	Die Sitzung wurde beendet, indem DEBUG_END_PASSIVE an EndSession-gesendet wurde.
DEBUG_SESSION_END	Das Ziel wurde abgeschlossen, und die Sitzung wurde beendet.
DEBUG_SESSION_REBOOT	Der Zielcomputer wurde neu gestartet und beendet die Sitzung.
DEBUG_SESSION_HIBERNATE	Der Zielcomputer ging in den Ruhezustand und beendet die Sitzung.
DEBUG_SESSION_FAILURE	Das Modul konnte die Sitzung nicht fortsetzen.

Rückgabewert

Der Rückgabewert dieser Methode wird vom Modul ignoriert.

Bemerkungen

Diese Methode wird nur vom Modul aufgerufen, wenn das DEBUG_EVENT_SESSION_STATUS Flag in der Maske festgelegt wird, die von IDebugEventCallbacksWide::GetInterestMaskzurückgegeben wird.

Nachdem das Modul alle Ereignisrückrufe über die Änderung im Sitzungsstatus benachrichtigt hat, benachrichtigt es auch alle geladenen Erweiterungen, die die DebugExtensionNotify Rückrufmethode exportieren. Der Wert, den er an die Erweiterungen übergibt, hängt vom Wert Statusab. Wenn Status DEBUG_SESSION_ACTIVE ist, wird DEBUG_SESSION_ACTIVE übergeben. andernfalls wird DEBUG_SESSION_INACTIVE übergeben.

Im DEBUG_SESSION_ACTIVE Fall folgt das Modul der Änderungsbenachrichtigung der Debuggersitzung mit einer Zielstatusänderungsbenachrichtigung, indem IDebugEventCallbacksWide::ChangeDebuggeeState für die Ereignisrückrufe aufgerufen und DEBUG_CDS_ALL im Flags Parameter übergeben wird. In allen anderen Fällen stellt das Modul dieser Benachrichtigung eine Modulstatusänderungsbenachrichtigung voran, indem IDebugEventCallbacksWide::ChangeEngineState für die Ereignisrückrufe aufgerufen und DEBUG_CES_EXECUTION_STATUS im Flags Parameter übergeben werden.

Weitere Informationen zum Behandeln von Ereignissen finden Sie unter Monitoring Events. Informationen zu Debuggersitzungen finden Sie unter Debugging Session and Execution Model.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)