IDebugClient3::CreateProcessAndAttachWide メソッド (dbgeng.h)

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

CreateProcessAndAttachWide メソッドは、指定したコマンドラインからプロセスを作成し、別のユーザーモードプロセスにアタッチします。作成されたプロセスは中断され、アタッチが完了したときにのみ実行できます。これにより、クライアントとサーバーの両方のプロセスをデバッグするときの大まかな同期が可能になります。

構文

HRESULT CreateProcessAndAttachWide(
  [in]           ULONG64 Server,
  [in, optional] PWSTR   CommandLine,
  [in]           ULONG   CreateFlags,
  [in]           ULONG   ProcessId,
  [in]           ULONG   AttachFlags
);

パラメーター

[in] Server

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

[in, optional] CommandLine

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

[in] CreateFlags

プロセスの作成時に使用するフラグを指定します。これらのフラグの詳細については、DEBUG_CREATE_PROCESS_OPTIONSを参照してください。CreateFlagsをします。

[in] ProcessId

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

[in] AttachFlags

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

戻り値

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

リターンコード	形容
S_OK	メソッドが成功しました。

備考

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

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

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

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

必要条件

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

次の方法で共有

IDebugClient3::CreateProcessAndAttachWide メソッド (dbgeng.h)

構文

パラメーター

戻り値

備考

必要条件

関連項目

フィードバック

その他のリソース