共用方式為


IDebugControl3::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,並傳遞包含單一命令的命令字串 pctpct 命令會起始下一個呼叫或傳回指令的步驟,但在逐步執行之前,pct 完成執行。 因此,在逐步執行之前,IDebugControl::Execute 傳回。 追蹤和 go 命令的運作方式類似。 具有此行為的命令範例包括 gghtatbtctpapc
 

要求

要求 價值
目標平臺 桌面
標頭 dbgeng.h (include Dbgeng.h)

另請參閱

ExecuteCommandFile

IDebugControl

IDebugControl2

IDebugControl3