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

規格需求

   
目標平臺 桌面
標頭 dbgeng.h (包含 Dbgeng.h)

另請參閱

ExecuteCommandFile

IDebugControl

IDebugControl2

IDebugControl3