(dbgmodel.h) IDataModelScriptDebugBreakpoint::GetPosition 方法
GetPosition 方法會傳回腳本中斷點的位置。 腳本調試程式必須傳回斷點所在原始程式碼內的行和數據行。 如果能夠這麼做,它也可以填入positionSpanEnd自變數所定義的結束位置,以傳回斷點所代表的來源範圍。 如果調試程式無法產生這個範圍,而且呼叫端要求它,則範圍結束位置的 Line 和 Column 字段應該填入為零,表示無法提供值。
調試程式也可以傳回行 (的文字,或範圍) 原始程式碼中的斷點存在於lineText自變數中。 雖然強烈建議調試程式傳回此值,但並非必要。 只有來源內的行和數據行位置是必要傳回值。 如果調試程式無法產生來源文字,則可能會在lineText自變數中傳回 nullptr。
語法
HRESULT GetPosition(
ScriptDebugPosition *position,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
參數
position
必須在腳本的原始碼中傳回斷點的行和數據行位置。
positionSpanEnd
如果調試程式能夠產生斷點所代表的來源範圍,它可以在此傳回範圍結尾的行和數據行位置。 如果沒有,結構的Line和Column值應該設定為零,表示無法提供值。
lineText
如果調試程式可以產生斷點所代表之原始程式碼的行 (或跨越) ,則會傳回這裡,例如透過 SysAllocString 函式配置的字串。 呼叫端負責透過 SysFreeString 釋放傳回的字串。 如果調試程式無法傳回此來源文字,則應在這裡傳回 nullptr。
傳回值
這個方法會傳回表示成功或失敗的 HRESULT。
規格需求
需求 | 值 |
---|---|
標頭 | dbgmodel.h |