Metodo IDebugClient5::CreateProcessWide (dbgeng.h)

Articolo
02/06/2025

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 utilizzare per il collegamento 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 specificata 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 utilizzare durante la creazione del processo. Per informazioni dettagliate su questi flag, vedere il CreateFlags membro della struttura DEBUG_CREATE_PROCESS_OPTIONS.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

Osservazioni

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 si collega anche al processo appena creato. Questo comportamento è simile a quello di CreateProcessAndAttach2 quando il relativo argomento ProcessId è impostato su zero.

Per altre informazioni sulla creazione e la connessione a destinazioni in modalità utente live, vedere Destinazioni User-Mode live.