IDataModelScript::Execute 方法 (dbgmodel.h)

Execute 方法會執行腳本的內容,如上次成功填入呼叫所指示,並根據該內容修改調試程序的物件模型。 如果語言 (或腳本提供者) 定義“main 函式”,則作者在使用者介面中單擊虛構的 [執行腳本] 按鈕時會呼叫的函式 ,即不會在 Execute 作業期間呼叫這類「主要函式」。 「執行」作業可以視為只執行初始化和物件模型操作 (例如:執行根程式代碼並設定擴充點) 。 腳本的執行是腳本提供者與腳本客戶端之間的雙向通訊。 錯誤、偵錯控件和其他語意會跨 IDataModelScript 和IDataModelScriptClient 之間的通道傳遞。

視執行作業成功或失敗而定,應該會發生兩件事之一:

若要成功傳回:

o 先前執行的腳本內容已排清並忘記

o 任何物件模型操作或擴充點都因先前執行腳本而變更,都已復原

o 新執行腳本的物件模型操作和擴充點為使用中

若傳回失敗:

o 未復原新嘗試執行腳本的任何操作或擴充點

o 還原腳本的先前狀態。 其所有物件模型操作和擴充點都會還原。

o 狀態應該是在成功填入呼叫之後,但在任何 Execute 呼叫之前的狀態

請注意,針對正確撰寫的腳本提供者和腳本環境,呼叫 Execute 方法多次,而不需對 Populate 或 Unlink 進行插播呼叫 ,應該是等冪的。 也就是說,在數據列中呼叫 Execute N 次應該與呼叫 Execute 一樣向用戶顯示。 執行不應該對偵錯目標的狀態產生副作用結果。 後續利用透過 Execute 方法產生的網橋屬性、方法或事件,可能會產生副作用結果。

語法

HRESULT Execute(
  IDataModelScriptClient *client
);

參數

client

要求執行之用戶端的介面應該在此傳遞。 如果在腳本執行期間發生錯誤或其他事件,客戶端應該透過此介面上的方法,通知這些事件及其在腳本中的位置。

傳回值

這個方法會傳回 HRESULT,指出成功或失敗。

規格需求

需求
標頭 dbgmodel.h

另請參閱

IDataModelScript 介面