IDebugEngineLaunch2 : : LaunchSuspended
Cette méthode exécute un processus à l'aide de le moteur de (DE) débogage.
HRESULT LaunchSuspended (
LPCOLESTR pszMachine,
IDebugPort2* pPort,
LPCOLESTR pszExe,
LPCOLESTR pszArgs,
LPCOLESTR pszDir,
BSTR bstrEnv,
LPCOLESTR pszOptions,
LAUNCH_FLAGS dwLaunchFlags,
DWORD hStdInput,
DWORD hStdOutput,
DWORD hStdError,
IDebugEventCallback2* pCallback,
IDebugProcess2** ppDebugProcess
);
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] Le nom de l'ordinateur dans lequel exécuter le processus. Utilisez une valeur NULL pour spécifier l'ordinateur local.pPort
[in] L'interface d' IDebugPort2 représentant le port dans lequel le programme s'exécute.pszExe
[in] Le nom du fichier exécutable à démarrer.pszArgs
[in] les arguments à passer au fichier exécutable. Peut être une valeur NULL si aucun argument n'est spécifié.pszDir
[in] le nom du répertoire de travail utilisé par le fichier exécutable. peut être une valeur NULL si aucun répertoire de travail n'est requis.bstrEnv
[in] Bloc environnement de chaînes terminée par le caractère NULL, suivi d'une marque de fin null supplémentaire.pszOptions
[in] les options pour le fichier exécutable.dwLaunchFlags
[in] spécifie LAUNCH_FLAGS pour une session.hStdInput
[in] Handle vers un autre flux d'entrée. peut être 0 si la redirection n'est pas requise.hStdOutput
[in] Handle vers un autre flux de sortie. peut être 0 si la redirection n'est pas requise.hStdError
[in] Handle vers un autre flux de sortie des erreurs. peut être 0 si la redirection n'est pas requise.pCallback
[in] l'objet d' IDebugEventCallback2 qui reçoit des événements de débogueur.ppDebugProcess
[out] Retourne l'objet résultant d' IDebugProcess2 qui représente le processus exécuté.
Valeur de retour
En cas de réussite, retourne S_OK; sinon, retourne un code d'erreur.
Notes
Normalement, Visual Studio exécute un programme à l'aide de la méthode d' IDebugPortEx2 : : LaunchSuspended puis joint le débogueur au programme suspendu. Toutefois, il existe des situations dans lesquelles le moteur de débogage peut devoir exécuter un programme (par exemple, si le moteur de débogage fait partie d'un interpréteur et du programme débogué est un langage interprète), auquel cas Visual Studio utilise la méthode d' IDebugEngineLaunch2::LaunchSuspended .
La méthode d' IDebugEngineLaunch2 : : ResumeProcess est appelée pour démarrer le processus une fois que le processus a été correctement lancé dans un état suspendu.