IDebugEngineLaunch2::LaunchSuspended

  • Artigo

Esse método inicia um processo por meio do mecanismo de depuração (DE).

Sintaxe

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
[em] O nome da máquina na qual iniciar o processo. Use um valor nulo para especificar a máquina local.

pPort
[em] A interface IDebugPort2 que representa a porta em que o programa será executado.

pszExe
[em] O nome do executável a ser iniciado.

pszArgs
[em] Os argumentos a serem passados para o executável. Pode ser um valor nulo se não houver argumentos.

pszDir
[em] O nome do diretório de trabalho usado pelo executável. Pode ser um valor nulo se nenhum diretório de trabalho for necessário.

bstrEnv
[em] Bloco de ambiente de cadeias de caracteres terminadas em NULL, seguido por um terminador NULL adicional.

pszOptions
[em] As opções para o executável.

dwLaunchFlags
[em] Especifica o LAUNCH_FLAGS de uma sessão.

hStdInput
[em] Manipule um fluxo de entrada alternativo. Pode ser 0 se o redirecionamento não for necessário.

hStdOutput
[em] Manipule um fluxo de saída alternativo. Pode ser 0 se o redirecionamento não for necessário.

hStdError
[em] Manipule um fluxo de saída de erro alternativo. Pode ser 0 se o redirecionamento não for necessário.

pCallback
[em] O objeto IDebugEventCallback2 que recebe eventos do depurador.

ppDebugProcess
[saiu] Retorna o objeto IDebugProcess2 resultante que representa o processo iniciado.

Valor de retorno

Se tiver êxito, retornará S_OK. Caso contrário, retornará um código de erro.

Comentários

Normalmente, o Visual Studio inicia um programa usando o método LaunchSuspended e, em seguida, anexa o depurador ao programa suspenso. No entanto, há circunstâncias em que o mecanismo de depuração pode precisar iniciar um programa (por exemplo, se o mecanismo de depuração faz parte de um interpretador e o programa que está sendo depurado é uma linguagem interpretada), caso em que o Visual Studio usa o IDebugEngineLaunch2::LaunchSuspended método.

O método ResumeProcess é chamado para iniciar o processo depois que o processo foi iniciado com êxito em um estado suspenso.

Confira também