共用方式為


(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

另請參閱

IDataModelScriptDebug2 介面