Metodo IDataModelScriptDebugBreakpoint::GetPosition (dbgmodel.h)
Il metodo GetPosition restituisce la posizione del punto di interruzione all'interno dello script. Il debugger dello script deve restituire la riga e la colonna all'interno del codice sorgente in cui si trova il punto di interruzione. Se è in grado di farlo, può anche restituire un intervallo di origine rappresentato dal punto di interruzione compilando una posizione finale come definito dall'argomento positionSpanEnd. Se il debugger non è in grado di produrre questo intervallo e il chiamante lo richiede, i campi Riga e Colonna della posizione finale dell'intervallo devono essere compilati come zero che indica che non è possibile specificare i valori.
Il debugger può anche restituire il testo della riga (o dell'intervallo) del codice sorgente in cui il punto di interruzione esiste nell'argomento lineText. Anche se è consigliabile che i debugger restituiscono questo valore, non è obbligatorio. Solo la posizione riga e colonna all'interno dell'origine sono valori restituiti obbligatori. Se il debugger non è in grado di produrre il testo di origine, è possibile che venga restituito nullptr nell'argomento lineText.
Sintassi
HRESULT GetPosition(
ScriptDebugPosition *position,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Parametri
position
La posizione riga e colonna del punto di interruzione all'interno del codice sorgente dello script deve essere restituita qui.
positionSpanEnd
Se il debugger è in grado di produrre l'intervallo di origine rappresentato dal punto di interruzione, può restituire qui le posizioni di riga e colonna della fine dell'intervallo. In caso contrario, i valori Line e Column della struttura devono essere impostati su zero per indicare che non è possibile specificare i valori.
lineText
Se il debugger può produrre la riga (o l'intervallo) del codice sorgente rappresentato dal punto di interruzione, viene restituito come una stringa allocata tramite la funzione SysAllocString. Il chiamante è responsabile della liberazione della stringa restituita tramite SysFreeString. Se il debugger non è in grado di restituire questo testo di origine, è necessario restituire nullptr qui.
Valore restituito
Questo metodo restituisce HRESULT che indica l'esito positivo o negativo.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | dbgmodel.h |