Metodo ICorDebug::CreateProcess
Avvia un processo e il relativo thread primario sotto il controllo del debugger.
Sintassi
HRESULT CreateProcess (
[in] LPCWSTR lpApplicationName,
[in] LPWSTR lpCommandLine,
[in] LPSECURITY_ATTRIBUTES lpProcessAttributes,
[in] LPSECURITY_ATTRIBUTES lpThreadAttributes,
[in] BOOL bInheritHandles,
[in] DWORD dwCreationFlags,
[in] PVOID lpEnvironment,
[in] LPCWSTR lpCurrentDirectory,
[in] LPSTARTUPINFOW lpStartupInfo,
[in] LPPROCESS_INFORMATION lpProcessInformation,
[in] CorDebugCreateProcessFlags debuggingFlags,
[out] ICorDebugProcess **ppProcess
);
Parametri
lpApplicationName [in] Puntatore a una stringa con terminazione Null che specifica il modulo da eseguire dal processo avviato. Il modulo viene eseguito nel contesto di sicurezza del processo chiamante.
lpCommandLine [in] Puntatore a una stringa con terminazione Null che specifica la riga di comando da eseguire dal processo avviato. Il nome dell'applicazione (ad esempio, "SomeApp.exe") deve essere il primo argomento.
lpProcessAttributes [in] Puntatore a una struttura Win32 SECURITY_ATTRIBUTES che specifica il descrittore di sicurezza per il processo. Se lpProcessAttributes è Null, il processo ottiene un descrittore di sicurezza predefinito.
lpThreadAttributes [in] Puntatore a una struttura Win32 SECURITY_ATTRIBUTES che specifica il descrittore di sicurezza per il thread primario del processo. Se lpThreadAttributes è Null, il thread ottiene un descrittore di sicurezza predefinito.
bInheritHandles [in] Impostare su true per indicare che ogni handle ereditabile nel processo chiamante viene ereditato dal processo avviato o false per indicare che gli handle non vengono ereditati. Gli handle ereditati hanno lo stesso valore e gli stessi diritti di accesso degli handle originali.
dwCreationFlags[in] Combinazione bit per bit dei flag di creazione del processo Win32 che controllano la classe di priorità e il comportamento del processo avviato.
lpEnvironment [in] Puntatore a un blocco di ambiente per il nuovo processo.
lpCurrentDirectory [in] Puntatore a una stringa con terminazione Null che specifica il percorso completo della directory corrente per il processo. Se questo parametro è Null, il nuovo processo avrà la stessa unità corrente e la stessa directory del processo chiamante.
lpStartupInfo [in] Puntatore a una struttura Win32 STARTUPINFOW che specifica la stazione della finestra, il desktop, gli handle standard e l'aspetto della finestra principale per il processo avviato.
lpProcessInformation [in] Puntatore a una struttura Win32 PROCESS_INFORMATION che specifica le informazioni di identificazione sul processo da avviare.
debuggingFlags [in] Valore dell'enumerazione CorDebugCreateProcessFlags che specifica le opzioni di debug.
ppProcess [out] Puntatore all'indirizzo di un oggetto ICorDebugProcess che rappresenta il processo.
Osservazioni:
I parametri di questo metodo sono uguali a quelli del metodo Win32 CreateProcess .
Per abilitare il debug in modalità mista non gestita, impostare su dwCreationFlags DEBUG_PROCESS | DEBUG_ONLY_THIS_PROCESS. Se si vuole usare solo il debug gestito, non impostare questi flag.
Se il debugger e il processo da sottoporre a debug (processo collegato) condividono una singola console e, se viene usato il debug di interoperabilità, è possibile che il processo collegato contenga blocchi della console e si arresti in un evento di debug. Il debugger bloccherà quindi qualsiasi tentativo di usare la console. Per evitare questo problema, impostare il flag CREATE_NEW_CONSOLE nel dwCreationFlags parametro .
Il debug di interoperabilità non è supportato nelle piattaforme Win9x e non x86, ad esempio le piattaforme basate su IA-64 e AMD64.
Requisiti
Piattaforme: vedere Requisiti di sistema.
Intestazione: CorDebug.idl, CorDebug.h
Libreria: CorGuids.lib
Versioni di .NET Framework: disponibili dalla versione 1.0
