IDebugControl4::ExecuteWide メソッド (dbgeng.h)

ExecuteWide メソッドは、指定したデバッガーコマンドを実行します。

構文

HRESULT ExecuteWide(
  [in] ULONG  OutputControl,
  [in] PCWSTR Command,
  [in] ULONG  Flags
);

[in] OutputControl

コマンドの実行中に使用する出力コントロールを指定します。使用可能な値については、「 DEBUG_OUTCTL_XXX」を参照してください。出力の詳細については、「入力と出力」を参照してください。

[in] Command

実行するコマンド文字列を指定します。コマンドは、デバッガーコマンドウィンドウに入力されたものと同様に解釈されます。このコマンド文字列には、エンジンが実行する複数のコマンドを含めることができます。コマンドリファレンスについては、「デバッガーコマンド」を参照してください。

[in] Flags

コマンドの実行オプションのビットフィールドを指定します。既定のオプションでは、コマンドをログに記録しますが、出力には送信しません。次の表に、設定できるビットの一覧を示します。

値	説明
DEBUG_EXECUTE_ECHO	コマンド文字列が出力に送信されます。
DEBUG_EXECUTE_NOT_LOGGED	コマンド文字列はログに記録されません。これは、DEBUG_EXECUTE_ECHOによってオーバーライドされます。
DEBUG_EXECUTE_NO_REPEAT	Command が空の文字列の場合は、最後のコマンドを繰り返さないでください。また、後で繰り返し実行するために現在のコマンド文字列を保存しないでください。

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

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

このメソッドは、指定されたコマンド文字列を実行します。文字列に複数のコマンドがある場合、これらのメソッドは、すべてのコマンドが実行されるまで戻りません。これにはターゲットが実行されるのを待つ必要があるため、これらのメソッドの完了には任意の時間がかかる場合があります。

要件	値
対象プラットフォーム	デスクトップ
Header	dbgeng.h (Dbgeng.h を含む)