ICorDebugRemote::CreateProcessEx, méthode

Article
05/10/2023

Lance un processus sur un ordinateur distant sous le débogueur.

Syntaxe

HRESULT CreateProcessEx (  
    [in]  ICorDebugRemoteTarget*      pRemoteTarget,  
    [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  
);

Paramètres

pRemoteTarget
[in] Pointeur vers une interface ICorDebugRemoteTarget. Permet de déterminer l’ordinateur distant sur lequel le processus sera lancé.

lpApplicationName
[in] Pointeur vers une chaîne terminée par null qui spécifie le module à exécuter par le processus lancé. Le module est exécuté dans le contexte de sécurité du processus appelant.

lpCommandLine
[in] Pointeur vers une chaîne terminée par null qui spécifie la ligne de commande à exécuter par le processus lancé.

lpProcessAttributes
[in] Inutilisé pour le débogage à distance.

lpThreadAttributes
[in] Inutilisé pour le débogage à distance.

bInheritHandles
[in] Inutilisé pour le débogage à distance.

dwCreationFlags
[in] Inutilisé pour le débogage à distance.

lpEnvironment
[in] Pointeur vers un bloc d’environnement pour le nouveau processus.

lpCurrentDirectory
[in] Pointeur vers une chaîne terminée par null qui spécifie le chemin complet au répertoire actif pour le processus. Si ce paramètre est null, le nouveau processus a le même lecteur et le même répertoire actifs que le processus appelant.

lpStartupInfo
[in] Inutilisé pour le débogage à distance.

lpProcessInformation
[in] Inutilisé pour le débogage à distance.

debuggingFlags
[in] Inutilisé pour le débogage à distance.

ppProcess
[out] Pointeur vers l’adresse d’un objet d’interface ICorDebugProcess qui représente le processus.

Valeur de retour

S_OK
Le processus a été lancé sur l’ordinateur distant et a retourné une « interface ICorDebugProcess » pour le débogage.

E_FAIL (ou autres codes de retour E_)
Impossible de lancer le processus sur l’ordinateur distant et de retourner une « interface ICorDebugProcess » pour le débogage.

Notes

Le débogage en mode mixte n’est pas pris en charge dans Silverlight.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : CorDebug.idl

Bibliothèque : CorGuids.lib

Versions de .NET Framework : 4.5, 4, 3.5 SP1

Partager via