Metodo IDebugClient3::CreateProcessWide (dbgeng.h)

Articolo
02/23/2024

Il metodo CreateProcessWide crea un processo dalla riga di comando specificata.

Sintassi

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

Parametri

[in] Server

Specifica il server di elaborazione da usare quando si collega al processo. Se Server è zero, il motore creerà un processo locale senza usare un server di elaborazione.

[in] CommandLine

Specifica la riga di comando da eseguire per creare il nuovo processo. Il metodo CreateProcessWide potrebbe modificare il contenuto della stringa fornita in questo parametro. Pertanto, questo parametro non può essere un puntatore alla memoria di sola lettura,ad esempio una variabile const o una stringa letterale. Il passaggio di una stringa costante in questo parametro può causare una violazione di accesso.

[in] CreateFlags

Specifica i flag da usare durante la creazione del processo. Per informazioni dettagliate su questi flag, vedere il membro CreateFlags della struttura DEBUG_CREATE_PROCESS_OPTIONS .

Valore restituito

Questo metodo può anche restituire valori di errore. Per altre informazioni, vedere Valori restituiti .

Codice restituito	Descrizione
S_OK	Il metodo è stato eseguito correttamente.

Commenti

Questo metodo è disponibile solo per il debug in modalità utente live.

Se CreateFlags contiene uno dei flag DEBUG_PROCESS o DEBUG_ONLY_THIS_PROCESS, il motore collega anche al processo appena creato. Questo comportamento è simile a quello di CreateProcessAndAttach2 quando l'argomento ProcessId è impostato su zero.

Per altre informazioni sulla creazione e l'associazione alle destinazioni in modalità utente live, vedere Destinazioni live User-Mode.