Partager via

ICorDebug ::CreateProcess, méthode

Lance un processus et son thread principal sous le contrôle du débogueur.

Syntaxe

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
);

Paramètres

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é. Le nom de l’application (par exemple, «SomeApp.exe») doit être le premier argument.

lpProcessAttributes [in] Pointeur vers une structure Win32 SECURITY_ATTRIBUTES qui spécifie le descripteur de sécurité pour le processus. Si lpProcessAttributes la valeur est Null, le processus obtient un descripteur de sécurité par défaut.

lpThreadAttributes [in] Pointeur vers une structure Win32 SECURITY_ATTRIBUTES qui spécifie le descripteur de sécurité pour le thread principal du processus. Si lpThreadAttributes la valeur est Null, le thread obtient un descripteur de sécurité par défaut.

bInheritHandles [in] Défini pour true indiquer que chaque handle pouvant hériter du processus appelant est hérité par le processus lancé ou false pour indiquer que les handles ne sont pas hérités. Les handles hérités ont la même valeur et les mêmes droits d’accès que les handles d’origine.

dwCreationFlags [in] Combinaison au niveau du bit des indicateurs de création de processus Win32 qui contrôlent la classe de priorité et le comportement du processus lancé.

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 d’accès complet au répertoire actif du processus. Si ce paramètre est null, le nouveau processus aura le même lecteur et le même répertoire actuels que le processus appelant.

lpStartupInfo [in] Pointeur vers une structure Win32 STARTUPINFOW qui spécifie la station de fenêtre, le bureau, les handles standard et l’apparence de la fenêtre principale pour le processus lancé.

lpProcessInformation [in] Pointeur vers une structure Win32 PROCESS_INFORMATION qui spécifie les informations d’identification sur le processus à lancer.

debuggingFlags [in] Valeur de l’énumération CorDebugCreateProcessFlags qui spécifie les options de débogage.

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

Remarques

Les paramètres de cette méthode sont identiques à ceux de la méthode Win32 CreateProcess .

Pour activer le débogage en mode mixte non managé, définissez dwCreationFlags sur DEBUG_PROCESS | DEBUG_ONLY_THIS_PROCESS. Si vous souhaitez utiliser uniquement le débogage managé, ne définissez pas ces indicateurs.

Si le débogueur et le processus à déboguer (le processus attaché) partagent une seule console et si le débogage d’interopérabilité est utilisé, il est possible que le processus attaché conserve les verrous de console et s’arrête à un événement de débogage. Le débogueur bloque ensuite toute tentative d’utilisation de la console. Pour éviter ce problème, définissez l’indicateur CREATE_NEW_CONSOLE dans le dwCreationFlags paramètre.

Le débogage d’interopérabilité n’est pas pris en charge sur les plateformes Win9x et non x86 telles que les plateformes BASÉEs sur IA-64 et AMD64.

Spécifications

Plates-formes: Consultez les systèmes d’exploitation pris en charge par .NET.

En-tête: CorDebug.idl, CorDebug.h

Bibliothèque: CorGuids.lib

Versions de .NET : Disponible depuis .NET Framework 1.0

Voir aussi

  • Last updated on