(dbgmodel.h) IDataModelScriptDebugStackFrame::GetPosition 方法
GetPosition 方法會傳回堆疊框架所代表腳本內的位置。 只有在腳本位於包含此框架的堆疊所代表的中斷內時,才能呼叫這個方法。 此框架內的線條和數據行位置一律會傳回。 如果調試程式能夠傳回腳本內「執行位置」的範圍,則可以在positionSpanEnd自變數中傳回結束位置。 如果調試程式無法執行此動作,則如果要求) 應設定為零,則範圍結尾的行和數據行值 (。
文字行 (或代表此圖文框的文字範圍) 可以選擇性地由支援它的調試程序傳回。 雖然強烈建議腳本調試程式每次嘗試傳回此文字,但不需要這類調試程式傳回超過框架的行和數據行位置。 如果不支援傳回文字,可以在lineText自變數中傳回 nullptr。
語法
HRESULT GetPosition(
ScriptDebugPosition *position,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
參數
position
調試程序應該在此自變數中填入框架的行和數據行位置。
positionSpanEnd
呼叫端可以透過在此傳遞非 nullptr 值,選擇性地要求代表此堆棧框架之文字範圍的結尾。 如果調試程式可以支援這類要求,它會在此傳回行和數據行位置;否則,數據結構的 [行] 和 [數據行] 字段應該設定為零,表示無法判斷值。
lineText
呼叫端可以選擇性地要求原始程式碼行 (或表示框架位置的span) 。 如果調試程式能夠傳回此專案,它應該會傳回這裡,例如 SysAllocString 函式所配置的字串。 呼叫端負責使用 SysFreeString 釋放配置的字串。 如果調試程式無法傳回此專案,則應在這裡傳回 nullptr。
傳回值
這個方法會傳回 HRESULT,表示成功或失敗。
規格需求
需求 | 值 |
---|---|
標頭 | dbgmodel.h |