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 是空字串,請勿重複最後一個命令,也不會儲存目前的命令字串以供稍後重複執行。 |
傳回值
這個方法也可以傳回錯誤值。 如需詳細資訊,請參閱 傳回值。
傳回碼 | 描述 |
---|---|
|
方法成功。 |
言論
這個方法會執行指定的命令字串。 如果字串有多個命令,在執行所有命令之前,這個方法將不會傳回。 如果命令序列牽涉到等候目標執行,這個方法可能需要任意的時間才能完成。
注意 請務必瞭解步驟命令執行的意義。 步驟命令會起始逐步執行動作,但不會等候逐步執行完成。 例如,假設您呼叫 IDebugControl::Execute,並傳遞包含單一命令的命令字串 pct。pct 命令會起始下一個呼叫或傳回指令的步驟,但在逐步執行之前,pct 完成執行。 因此,在逐步執行之前,IDebugControl::Execute 傳回。 追蹤和 go 命令的運作方式類似。 具有此行為的命令範例包括 g、gh、ta、tb、tct、pa和 pc。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | dbgeng.h (include Dbgeng.h) |