(dbgmodel.h) IDataModelScriptDebug2::GetCurrentPosition 方法
GetCurrentPosition' 方法會傳回腳本中的目前位置。 只有當腳本中斷至調試程式時,才會呼叫此腳本,其中呼叫 GetScriptState 會傳回 ScriptDebugBreak。 對這個方法的任何其他呼叫都無效,而且會失敗。
腳本的位置定義為字元範圍。 必須一律傳回範圍開頭, (行號和數據行編號) 。 如果特定調試程式能夠傳回腳本中「目前位置」的完整範圍,則可以選擇性地在positionSpanEnd自變數中傳回結束位置。 如果調試程式無法執行此動作,則如果要求) 應設定為零,則範圍結尾的行和數據行值 (。
如果調試程式可以傳遞調試程式中斷之程式代碼行的原始程式碼,它可能會從這個方法傳回這類程序代碼。 可能的話,強烈建議您提供這項資訊。 不過,不需要傳回中斷位置的起始行和數據行以外的任何資訊。 如果不支援源行資訊,可能會傳回該自變數的 nullptr 值。
語法
HRESULT GetCurrentPosition(
ScriptDebugPosition *currentPosition,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
參數
currentPosition
必須在這裡傳回腳本的目前中斷位置。 傳回結構的 [線條] 和 [數據行] 欄位是以一個為基礎。 任一中的零值表示信息無法使用。
positionSpanEnd
如果調試程式能夠判斷中斷位置的完整範圍,則可以在這裡傳回範圍的結束位置。 如果不是,應該將零值填入傳回結構的 [行] 和 [數據行] 字段。
lineText
如果調試程式能夠傳回行 (的原始程式碼或中斷範圍) ,則可以在這裡傳回為 SysAllocString 函式所配置的字串。 呼叫端負責使用 SysFreeString 釋放傳回的字串。 如果調試程式無法產生此來源資訊,則應傳回 nullptr。
傳回值
這個方法會傳回表示成功或失敗的 HRESULT。
規格需求
需求 | 值 |
---|---|
標頭 | dbgmodel.h |