IDebugClient5::CreateProcess2Wide-Methode (dbgeng.h)

Artikel
02/06/2025

Die CreateProcess2Wide--Methode führt den angegebenen Befehl aus, um einen neuen Prozess zu erstellen.

Syntax

HRESULT CreateProcess2Wide(
  [in]           ULONG64 Server,
  [in]           PWSTR   CommandLine,
  [in]           PVOID   OptionsBuffer,
  [in]           ULONG   OptionsBufferSize,
  [in, optional] PCWSTR  InitialDirectory,
  [in, optional] PCWSTR  Environment
);

Parameter

[in] Server

Gibt den Prozessserver an, der an den Prozess angefügt wird. Wenn Server- null ist, erstellt das Modul den lokalen Prozess, ohne einen Prozessserver zu verwenden.

[in] CommandLine

Gibt die Befehlszeile an, die ausgeführt werden soll, um den neuen Prozess zu erstellen.

[in] OptionsBuffer

Gibt die Prozesserstellungsoptionen an. OptionsBuffer ist ein Zeiger auf eine DEBUG_CREATE_PROCESS_OPTIONS Struktur.

[in] OptionsBufferSize

Gibt die Größe des Puffers OptionsBuffer-an. Dies sollte auf Sizeof(DEBUG_CREATE_PROCESS_OPTIONS)festgelegt werden.

[in, optional] InitialDirectory

Gibt das Startverzeichnis für den Prozess an. Wenn InitialDirectory-NULL-ist, wird das aktuelle Verzeichnis für den Prozessserver verwendet.

[in, optional] Environment

Gibt einen Umgebungsblock für den neuen Prozess an. Ein Umgebungsblock besteht aus einem null-beendeten Block mit null-beendeten Zeichenfolgen. Jede Zeichenfolge weist das Format auf:

name=value

Beachten Sie, dass die letzten beiden Zeichen des Umgebungsblocks sowohl NULL-sind: eine, um die Zeichenfolge zu beenden, und eine, um den Block zu beenden.

Wenn Umgebungs- auf NULL-festgelegt ist, erbt der neue Prozess den Umgebungsblock des Prozessservers. Wenn das DEBUG_CREATE_PROCESS_THROUGH_RTL-Flag in OptionsBuffer-festgelegt ist, muss Umgebungs-NULL-sein.

Rückgabewert

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

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Diese Methode ist nur für das Debuggen im Live-Benutzermodus verfügbar.

Wenn CreateFlags- eines der Flags DEBUG_PROCESS oder DEBUG_ONLY_THIS_PROCESS enthält, wird das Modul auch an den neu erstellten Prozess angefügt. Dies ähnelt dem Verhalten CreateProcessAndAttach2- mit dem Argument ProcessId auf Null festgelegt.

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