IDebugControl2::Execute メソッド (dbgeng.h)

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

構文

HRESULT Execute(
  [in] ULONG OutputControl,
  [in] PCSTR 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	メソッドが成功しました。

備考

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

注 ステップ コマンドを実行する場合の意味を理解しておくことが重要です。 ステップ コマンドはステップ実行アクションを開始しますが、ステップ実行が完了するまで待機しません。 たとえば、IDebugControl::Execute を呼び出し、pct 単一コマンドを含むコマンド文字列を渡すとします。pct コマンドは、次の呼び出しまたは戻り命令へのステップを開始しますが、pct は、ステップ実行が行われる前にその実行を完了します。 その結果、IDebugControl::Execute は、ステップ実行が行われる前に返されます。 トレースコマンドと go コマンドも同様の動作をします。 この動作を持つコマンドの例としては、g、gh、ta、tb、tct、pa、pc があります。

 

必要条件

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

関連項目

ExecuteCommandFile の

IDebugControl の

IDebugControl2 の

IDebugControl3 の