IDebugEngineLaunch2::LaunchSuspended

  • Artículo

Este método inicia un proceso mediante el motor de depuración (DE).

Sintaxis

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

Parámetros

pszMachine
[in] Nombre de la máquina en la que se va a iniciar el proceso. Use un valor NULL para especificar el equipo local.

pPort
[in] Interfaz IDebugPort2 que representa el puerto en el que se ejecutará el programa.

pszExe
[in] Nombre del archivo ejecutable que se va a iniciar.

pszArgs
[in] Argumentos que se van a pasar al archivo ejecutable. Puede ser un valor NULL si no hay argumentos.

pszDir
[in] Nombre del directorio de trabajo usado por el ejecutable. Puede ser un valor NULL si no se requiere ningún directorio de trabajo.

bstrEnv
[in] Bloque de entorno de cadenas terminadas en NULL, seguido de un terminador NULL adicional.

pszOptions
[in] Las opciones del archivo ejecutable.

dwLaunchFlags
[in] Especifica el LAUNCH_FLAGS de una sesión.

hStdInput
[in] Controle a un flujo de entrada alternativo. Puede ser 0 si no se requiere redireccionamiento.

hStdOutput
[in] Controle a un flujo de salida alternativo. Puede ser 0 si no se requiere redireccionamiento.

hStdError
[in] Controlar a un flujo de salida de error alternativo. Puede ser 0 si no se requiere redireccionamiento.

pCallback
[in] Objeto IDebugEventCallback2 que recibe eventos del depurador.

ppDebugProcess
[out] Devuelve el objeto IDebugProcess2 resultante que representa el proceso iniciado.

Valor devuelto

Si la operación se realiza correctamente, devuelve S_OK; de lo contrario, devuelve un código de error.

Comentarios

Normalmente, Visual Studio inicia un programa mediante el método LaunchSuspended y, a continuación, asocia el depurador al programa suspendido. Sin embargo, hay circunstancias en las que el motor de depuración puede necesitar iniciar un programa (por ejemplo, si el motor de depuración forma parte de un intérprete y el programa que se depura es un lenguaje interpretado), en cuyo caso Visual Studio usa el IDebugEngineLaunch2::LaunchSuspended método .

Se llama al método ResumeProcess para iniciar el proceso después de que el proceso se haya iniciado correctamente en un estado suspendido.

Consulte también