IDebugEngineLaunch2::LaunchSuspended

  • Article

Cette méthode lance un processus au moyen du moteur de débogage (DE).

Syntaxe

int LaunchSuspended(
   string               pszServer,
   IDebugPort2          pPort,
   string               pszExe,
   string               pszArgs,
   string               pszDir,
   string               bstrEnv,
   string               pszOptions,
   enum_LAUNCH_FLAGS    dwLaunchFlags,
   uint                 hStdInput,
   uint                 hStdOutput,
   uint                 hStdError,
   IDebugEventCallback2 pCallback,
   out IDebugProcess2   ppProcess
);

Paramètres

pszMachine
[in] Nom de l’ordinateur dans lequel lancer le processus. Utilisez une valeur Null pour spécifier l’ordinateur local.

pPort
[in] Interface IDebugPort2 représentant le port dans lequel le programme s’exécutera.

pszExe
[in] Nom de l’exécutable à lancer.

pszArgs
[in] Arguments à passer à l’exécutable. Peut être une valeur Null s’il n’existe aucun argument.

pszDir
[in] Nom du répertoire de travail utilisé par l’exécutable. Peut être une valeur Null si aucun répertoire de travail n’est requis.

bstrEnv
[in] Bloc d’environnement de chaînes terminées par NULL, suivi d’un point de terminaison NULL supplémentaire.

pszOptions
[in] Options de l’exécutable.

dwLaunchFlags
[in] Spécifie la LAUNCH_FLAGS d’une session.

hStdInput
[in] Gérer vers un autre flux d’entrée. Peut être 0 si la redirection n’est pas nécessaire.

hStdOutput
[in] Gérer vers un autre flux de sortie. Peut être 0 si la redirection n’est pas nécessaire.

hStdError
[in] Gérez un autre flux de sortie d’erreur. Peut être 0 si la redirection n’est pas nécessaire.

pCallback
[in] Objet IDebugEventCallback2 qui reçoit des événements de débogueur.

ppDebugProcess
[out] Retourne l’objet IDebugProcess2 résultant qui représente le processus lancé.

Valeur de retour

En cas de réussite, retourne S_OK , sinon, retourne un code d'erreur.

Notes

Normalement, Visual Studio lance un programme à l’aide de la méthode LaunchSuspended , puis attache le débogueur au programme suspendu. Toutefois, il existe des circonstances dans lesquelles le moteur de débogage peut avoir besoin de lancer un programme (par exemple, si le moteur de débogage fait partie d’un interpréteur et que le programme en cours de débogage est un langage interprété), auquel cas Visual Studio utilise la IDebugEngineLaunch2::LaunchSuspended méthode.

La méthode ResumeProcess est appelée pour démarrer le processus une fois le processus lancé avec succès dans un état suspendu.

Voir aussi