IDebugClient4::CreateProcessWide-Methode (dbgeng.h)

Artikel
02/23/2024

Die CreateProcessWide-Methode erstellt einen Prozess über die angegebene Befehlszeile.

Syntax

HRESULT CreateProcessWide(
  [in] ULONG64 Server,
  [in] PWSTR   CommandLine,
  [in] ULONG   CreateFlags
);

Parameter

[in] Server

Gibt den Prozessserver an, der beim Anfügen an den Prozess verwendet werden soll. Wenn Server null ist, erstellt die Engine einen lokalen Prozess, ohne einen Prozessserver zu verwenden.

[in] CommandLine

Gibt die Befehlszeile an, die zum Erstellen des neuen Prozesses ausgeführt werden soll. Die CreateProcessWide-Methode kann den Inhalt der Zeichenfolge ändern, die Sie in diesem Parameter angeben. Daher kann dieser Parameter kein Zeiger auf schreibgeschützten Arbeitsspeicher (z. B. eine const-Variable oder eine Literalzeichenfolge) sein. Das Übergeben einer konstanten Zeichenfolge in diesem Parameter kann zu einer Zugriffsverletzung führen.

[in] CreateFlags

Gibt die Flags an, die beim Erstellen des Prozesses verwendet werden sollen. Ausführliche Informationen zu diesen Flags finden Sie im CreateFlags-Element der DEBUG_CREATE_PROCESS_OPTIONS-Struktur .

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 CreateFlags eines der Flags DEBUG_PROCESS oder DEBUG_ONLY_THIS_PROCESS enthält, wird die Engine auch an den neu erstellten Prozess angefügt. Dieses Verhalten ähnelt dem von CreateProcessAndAttach2 , wenn dessen Argument ProcessId auf 0 (null) festgelegt ist.

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