IDebugControl3：：Execute 方法 (dbgeng.h)

發行項
02/23/2024

Execute 方法會執行指定的調試程式命令。

語法

HRESULT Execute(
  [in] ULONG OutputControl,
  [in] PCSTR Command,
  [in] ULONG Flags
);

參數

[in] OutputControl

指定要在執行命令時使用的輸出控制件。如需可能的值，請參閱 DEBUG_OUTCTL_XXX。如需輸出的詳細資訊，請參閱輸入和輸出。

[in] Command

指定要執行的命令字串。命令會解譯為類似輸入調試程式命令視窗的命令。此命令字串可以包含要執行引擎的多個命令。如需命令參考，請參閱調試程式命令。

[in] Flags

指定命令的執行選項位欄位。默認選項是記錄命令，但不要將它傳送至輸出。下表列出可設定的位。

值	Description
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 命令的行為類似。具有此行為的命令範例包括 g、 gh、 ta、 tb、 tct、 pa 和 pc。