IDebugSystemObjects2::SetCurrentProcessId-Methode (dbgeng.h)

Die SetCurrentProcessId-Methode macht den angegebenen Prozess zum aktuellen Prozess.

Syntax

HRESULT SetCurrentProcessId(
  [in] ULONG Id
);

Parameter

[in] Id

Gibt die Engine-Prozess-ID für den Prozess an, der zum aktuellen Prozess werden soll.

Rückgabewert

Diese Methode kann auch andere Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
E_NOINTERFACE	Es wurde kein Prozess mit der angegebenen Prozess-ID gefunden.
E_FAIL	Im Prozess wurde kein geeigneter Kandidat für den aktuellen Thread gefunden.

Hinweise

Diese Methode ändert auch den aktuellen Thread und kann das aktuelle Ziel und den aktuellen Computer ändern.

Wenn der Prozess geändert wird, wird der Rückruf IDebugEventCallbacks::ChangeEngineState mit dem DEBUG_CES_CURRENT_THREAD Bitsatz aufgerufen.

Hinweis Beim Debuggen im Kernelmodus ist der aktuelle Prozess ein virtueller Prozess, kein Systemprozess. Diese Methode kann nicht verwendet werden, um beim Debuggen im Kernelmodus zwischen Systemprozessen zu wechseln. Der implizite Prozess kann jedoch mithilfe von SetImplicitProcessDataOffset geändert werden.

 

Weitere Informationen zu Prozessen finden Sie unter Threads und Prozesse. Ausführliche Informationen zu Überwachungsereignissen finden Sie unter Überwachen von Ereignissen.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	dbgeng.h (einschließlich Dbgeng.h)