次の方法で共有


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 を呼び出し、1 つのコマンド pct を含むコマンド文字列を渡すとします。 pct コマンドは、次の呼び出しまたは戻り命令へのステップを開始しますが、 pct はステップ実行が行われる前に実行を完了します。 その結果、ステップ実行が行われる前に IDebugControl::Execute が返されます。 トレースコマンドと go コマンドも同様に動作します。 この動作を持つコマンドの例としては、 gghtatbtctpapc などがあります
 

要件

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

こちらもご覧ください

ExecuteCommandFile

IDebugControl

IDebugControl2

IDebugControl3