このメソッドは、デバッグ エンジン (DE) によってプロセスを起動します。
構文
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
);
パラメーター
pszMachine
[入力] プロセスを起動するコンピューターの名前。 ローカル コンピューターを指定するには、null 値を使用します。
pPort
[入力] プログラムが実行されるポートを表す IDebugPort2 インターフェイス。
pszExe
[入力] 起動する実行可能ファイルの名前。
pszArgs
[入力] 実行可能ファイルに渡す引数。 引数がない場合は、null 値にすることができます。
pszDir
[入力] 実行可能ファイルによって使用される作業ディレクトリの名前。 作業ディレクトリが不要な場合は、null 値にすることができます。
bstrEnv
[入力] NULL で終わる文字列の環境ブロックと、それに続く追加の NULL ターミネータ。
pszOptions
[入力] 実行可能ファイルのオプション。
dwLaunchFlags
[入力] セッションの LAUNCH_FLAGS を指定します。
hStdInput
[入力] 代替入力ストリームへのハンドル。 リダイレクトが不要な場合は 0 にすることができます。
hStdOutput
[入力] 代替出力ストリームへのハンドル。 リダイレクトが不要な場合は 0 にすることができます。
hStdError
[入力] 代替エラー出力ストリームへのハンドル。 リダイレクトが不要な場合は 0 にすることができます。
pCallback
[入力] デバッガー イベントを受け取る IDebugEventCallback2 オブジェクト。
ppDebugProcess
[出力] 起動されたプロセスを表す、結果の IDebugProcess2 オブジェクトを返します。
戻り値
成功した場合は、S_OK を返します。それ以外の場合は、エラー コードを返します。
解説
通常、Visual Studio は LaunchSuspended メソッドを使用してプログラムを起動してから、一時停止されたプログラムにデバッガーをアタッチします。 ただし、状況によっては、デバッグ エンジンがプログラムを起動することが必要な場合があります (たとえば、デバッグ エンジンがインタープリターの一部であり、デバッグ中のプログラムがインタープリター言語である場合)。そのような場合、Visual Studio では IDebugEngineLaunch2::LaunchSuspended メソッドが使用されます。
ResumeProcess メソッドは、プロセスが一時停止状態で正常に起動された後にプロセスを開始するために呼び出されます。