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

[アーティクル]
02/26/2024

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

構文

HRESULT CreateProcessAndAttach2Wide(
  [in]           ULONG64 Server,
  [in, optional] PWSTR   CommandLine,
  [in]           PVOID   OptionsBuffer,
  [in]           ULONG   OptionsBufferSize,
  [in, optional] PCWSTR  InitialDirectory,
  [in, optional] PCWSTR  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 つはブロックを終了します。

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

[in] ProcessId

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

[in] AttachFlags

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

戻り値

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

リターンコード	説明
S_OK	メソッドは正常に実行されました。
E_INVALIDARG	これは、CommandLine が NULL で、ProcessId が 0 の場合に返されます。