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

[アーティクル]
08/07/2023

CreateProcessWide メソッドは、指定したコマンドラインからプロセスを作成します。

構文

HRESULT CreateProcessWide(
  [in] ULONG64 Server,
  [in] PWSTR   CommandLine,
  [in] ULONG   CreateFlags
);

パラメーター

[in] Server

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

[in] CommandLine

新しいプロセスを作成するために実行するコマンドラインを指定します。 CreateProcessWide メソッドは、このパラメーターで指定した文字列の内容を変更する場合があります。したがって、このパラメーターは読み取り専用メモリ (const 変数やリテラル文字列など) へのポインターにすることはできません。このパラメーターに定数文字列を渡すと、アクセス違反が発生する可能性があります。

[in] CreateFlags

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

戻り値

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

リターンコード	説明
S_OK	メソッドは正常に実行されました。

注釈

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

CreateFlags にDEBUG_PROCESSまたはDEBUG_ONLY_THIS_PROCESSのいずれかのフラグが含まれている場合、エンジンは新しく作成されたプロセスにもアタッチします。引数 ProcessId が 0 に設定されている場合、この動作は CreateProcessAndAttach2 の動作に似ています。

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