IDebugControl::ExecuteCommandFile メソッド (dbgeng.h)

ExecuteCommandFile メソッドは、指定したファイルを開き、その中に含まれるデバッガーコマンドを実行します。

構文

HRESULT ExecuteCommandFile(
  [in] ULONG OutputControl,
  [in] PCSTR CommandFile,
  [in] ULONG Flags
);

[in] OutputControl

コマンドの出力を送信する場所を指定します。使用可能な値については、「 DEBUG_OUTCTL_XXX」を参照してください。出力の詳細については、「入力と出力」を参照してください。

[in] CommandFile

実行するコマンドを含むファイルの名前を指定します。このファイルは読み取り用に開き、その内容はデバッガーコンソールに入力されたかのように解釈されます。

[in] Flags

コマンドの実行オプションを指定します。既定のオプションでは、コマンドをログに記録しますが、出力には送信しません。 フラグで取得できる値の詳細については、「実行」を参照してください。

このメソッドは、指定されたファイルを開けできなかった場合に発生したエラー値など、エラー値を返す場合もあります。詳細については、「戻り値」を参照してください。

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

このメソッドは、指定されたファイルを読み取り、Execute を使用して一度に 1 行ずつコマンドを実行します。行の実行中に例外が発生した場合、実行は次の行で続行されます。

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