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

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

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 コマンドも同様に動作します。この動作を持つコマンドの例としては、 g、 gh、 ta、 tb、 tct、 pa、 pc などがあります。