IDebugClient5::CreateProcessAndAttach2 メソッド (dbgeng.h)

[アーティクル]
02/06/2025

CreateProcessAndAttach2 メソッドは、指定したコマンドラインからプロセスを作成し、そのプロセスまたは別のユーザーモードプロセスにアタッチします。

構文

HRESULT CreateProcessAndAttach2(
  [in]           ULONG64 Server,
  [in, optional] PSTR    CommandLine,
  [in]           PVOID   OptionsBuffer,
  [in]           ULONG   OptionsBufferSize,
  [in, optional] PCSTR   InitialDirectory,
  [in, optional] PCSTR   Environment,
  [in]           ULONG   ProcessId,
  [in]           ULONG   AttachFlags
);

パラメーター

[in] Server

プロセスへのアタッチに使用するプロセスサーバーを指定します。 Server が 0 の場合、エンジンはプロセスサーバーを使用せずにローカルプロセスに接続します。

[in, optional] CommandLine

新しいプロセスを作成するために実行するコマンドラインを指定します。 CommandLine が NULL 場合、プロセスは作成されません。これらのメソッドは、ProcessId を使用して既存のプロセスにアタッチします。

[in] OptionsBuffer

プロセス作成オプションを指定します。 OptionsBuffer は、DEBUG_CREATE_PROCESS_OPTIONS 構造体へのポインターです。

[in] OptionsBufferSize

OptionsBuffer バッファーのサイズを指定します。これは、sizeof(DEBUG_CREATE_PROCESS_OPTIONS)に設定する必要があります。

[in, optional] InitialDirectory

プロセスの開始ディレクトリを指定します。このパラメーターは、CommandLine が NULL でない場合にのみ使用されます。 InitialDirectory NULL 場合は、プロセスサーバーの現在のディレクトリが使用されます。

[in, optional] Environment

新しいプロセスの環境ブロックを指定します。環境ブロックは、null で終わる文字列の null で終わるブロックで構成されます。各文字列の形式は次のとおりです。

name=value

環境ブロックの最後の 2 文字はどちらも NULL されることに注意してください。1 つは文字列を終了し、1 つはブロックを終了します。

環境が NULL 設定されている場合、新しいプロセスはプロセスサーバーの環境ブロックを継承します。 OptionsBuffer でDEBUG_CREATE_PROCESS_THROUGH_RTL フラグが設定されている場合、環境は NULL する必要があります。

[in] ProcessId

デバッガーがアタッチするターゲットプロセスのプロセス ID を指定します。 ProcessID が 0 の場合、デバッガーは CommandLine から作成したプロセスアタッチします。

[in] AttachFlags

デバッガーがターゲットプロセスにアタッチする方法を制御するフラグを指定します。これらのフラグの詳細については、DEBUG_ATTACH_XXXを参照してください。

戻り値

このメソッドは、エラー値を返す場合もあります。詳細については戻り値のを参照してください。

リターンコード	形容
S_OK	メソッドが成功しました。
E_INVALIDARG	これは、CommandLine が NULL 、ProcessId が 0 の場合に返されます。

備考

このメソッドは、ライブユーザーモードデバッグでのみ使用できます。

CommandLine が NULL されず、ProcessId が 0 でない場合、エンジンは中断状態でプロセスを作成します。エンジンは、ProcessIdで指定されたプロセスに正常に接続した後、この新しく作成されたプロセスを再開します。

注WaitForEvent メソッドが呼び出されるまで、エンジンはプロセスに完全にアタッチされません。プロセスによってイベントが生成された後 (たとえば、create-process イベント) は、デバッガーセッションで使用できるようになります。

ライブユーザーモードターゲットの作成とアタッチの詳細については、「Live User-Mode Targets」を参照してください。

必要条件

要件	価値
ターゲットプラットフォームの	デスクトップ
ヘッダー	dbgeng.h (Dbgeng.h を含む)

次の方法で共有

IDebugClient5::CreateProcessAndAttach2 メソッド (dbgeng.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース