IDebugEngineLaunch2::LaunchSuspendedIDebugEngineLaunch2::LaunchSuspended

Esse método inicia um processo por meio do mecanismo de depuração (DES).This method launches a process by means of the debug engine (DE).

SintaxeSyntax

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

ParâmetrosParameters

pszMachine
[in] O nome do computador no qual iniciar o processo.[in] The name of the machine in which to launch the process. Use um valor nulo para especificar o computador local.Use a null value to specify the local machine.

pPort
[in] O IDebugPort2 interface que representa a porta que o programa será executado em.[in] The IDebugPort2 interface representing the port that the program will run in.

pszExe
[in] O nome do executável a ser iniciado.[in] The name of the executable to be launched.

pszArgs
[in] Os argumentos a serem passados para o executável.[in] The arguments to pass to the executable. Pode ser um valor nulo se não houver nenhum argumento.May be a null value if there are no arguments.

pszDir
[in] O nome do diretório de trabalho usado pelo executável.[in] The name of the working directory used by the executable. Pode ser um valor nulo se nenhum diretório de trabalho é necessário.May be a null value if no working directory is required.

bstrEnv
[in] Bloco de ambiente de cadeias de caracteres terminada em nulo, seguido por um terminador nulo adicional.[in] Environment block of NULL-terminated strings, followed by an additional NULL terminator.

pszOptions
[in] As opções para o executável.[in] The options for the executable.

dwLaunchFlags
[in] Especifica o LAUNCH_FLAGS para uma sessão.[in] Specifies the LAUNCH_FLAGS for a session.

hStdInput
[in] Identificador para um fluxo de entrada alternativo.[in] Handle to an alternate input stream. Pode ser 0 se o redirecionamento não for necessário.May be 0 if redirection is not required.

hStdOutput
[in] Identificador para um fluxo de saída alternativos.[in] Handle to an alternate output stream. Pode ser 0 se o redirecionamento não for necessário.May be 0 if redirection is not required.

hStdError
[in] Identificador para um fluxo de saída de erro alternativa.[in] Handle to an alternate error output stream. Pode ser 0 se o redirecionamento não for necessário.May be 0 if redirection is not required.

pCallback
[in] O IDebugEventCallback2 objeto que recebe eventos do depurador.[in] The IDebugEventCallback2 object that receives debugger events.

ppDebugProcess
[out] Retorna o resultante IDebugProcess2 objeto que representa o processo iniciado.[out] Returns the resulting IDebugProcess2 object that represents the launched process.

Valor de retornoReturn Value

Se for bem-sucedido, retornará S_OK; caso contrário, retorna um código de erro.If successful, returns S_OK; otherwise, returns an error code.

ComentáriosRemarks

Normalmente, Visual StudioVisual Studio inicia um programa usando o LaunchSuspended método e, em seguida, anexa o depurador ao programa suspenso.Normally, Visual StudioVisual Studio launches a program using the LaunchSuspended method and then attaches the debugger to the suspended program. No entanto, há circunstâncias em que o mecanismo de depuração talvez precise iniciar um programa (por exemplo, se o mecanismo de depuração é parte de um interpretador e o programa que está sendo depurado é uma linguagem interpretada), caso em que Visual StudioVisual Studio usa o IDebugEngineLaunch2::LaunchSuspended método .However, there are circumstances in which the debug engine may need to launch a program (for example, if the debug engine is part of an interpreter and the program being debugged is an interpreted language), in which case Visual StudioVisual Studio uses the IDebugEngineLaunch2::LaunchSuspended method.

O ResumeProcess método é chamado para iniciar o processo depois que o processo foi iniciado com êxito em um estado suspenso.The ResumeProcess method is called to start the process after the process has been successfully launched in a suspended state.

Consulte tambémSee also