IDebugClient3::CreateProcessAndAttach-Methode (dbgeng.h)

Artikel
02/23/2024

Die CreateProcessAndAttach-Methode erstellt einen Prozess aus einer angegebenen Befehlszeile und fügt dann an einen anderen Benutzermodusprozess an. Der erstellte Prozess wird angehalten und kann nur ausgeführt werden, wenn die Anfügung abgeschlossen ist. Dies ermöglicht eine grobe Synchronisierung beim Debuggen von Client- und Serverprozessen.

Syntax

HRESULT CreateProcessAndAttach(
  [in]           ULONG64 Server,
  [in, optional] PSTR    CommandLine,
  [in]           ULONG   CreateFlags,
  [in]           ULONG   ProcessId,
  [in]           ULONG   AttachFlags
);

Parameter

[in] Server

Gibt den Prozessserver an, der zum Anfügen an den Prozess verwendet werden soll. Wenn Server null ist, stellt die Engine eine Verbindung mit dem lokalen Prozess her, ohne einen Prozessserver zu verwenden.

[in, optional] CommandLine

Gibt die Befehlszeile an, die zum Erstellen des neuen Prozesses ausgeführt werden soll. Wenn CommandLineNULL ist, wird kein Prozess erstellt, und diese Methoden werden wie AttachProcess an einen vorhandenen Prozess angefügt.

[in] CreateFlags

Gibt die Flags an, die beim Erstellen des Prozesses verwendet werden sollen. Ausführliche Informationen zu diesen Flags finden Sie unter DEBUG_CREATE_PROCESS_OPTIONS. CreateFlags.

[in] ProcessId

Gibt die Prozess-ID des Zielprozesses an, an den der Debugger angefügt wird. Wenn ProcessId null ist, wird der Debugger an den Prozess angefügt, den er über CommandLine erstellt hat.

[in] AttachFlags

Gibt die Flags an, die steuern, wie der Debugger an den Zielprozess anfügt. Ausführliche Informationen zu diesen Flags finden Sie unter DEBUG_ATTACH_XXX.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

Diese Methode ist nur für das Debuggen im Livebenutzermodus verfügbar.

Wenn CommandLine nicht NULL und ProcessId nicht 0 ist, erstellt die Engine den Prozess in einem angehaltenen Zustand. Die Engine setzt diesen neu erstellten Prozess fort, nachdem sie erfolgreich eine Verbindung mit dem in ProcessId angegebenen Prozess hergestellt hat.

Hinweis Die Engine wird erst vollständig an den Prozess angefügt, wenn die WaitForEvent-Methode aufgerufen wurde. Erst nachdem der Prozess ein Ereignis (z. B. das Create-Process-Ereignis) generiert hat, wird es in der Debuggersitzung verfügbar.

Weitere Informationen zum Erstellen und Anfügen an Livebenutzermodusziele finden Sie unter Live User-Mode Targets.