Metodo IDataModelScriptDebugStackFrame::GetPosition (dbgmodel.h)
Il metodo GetPosition restituisce la posizione all'interno dello script rappresentato dal frame dello stack. Questo metodo può essere chiamato solo quando lo script si trova all'interno di un'interruzione rappresentata dallo stack in cui è contenuto questo frame. La posizione della riga e della colonna all'interno di questa cornice viene sempre restituita. Se il debugger è in grado di restituire l'intervallo della "posizione di esecuzione" all'interno dello script, è possibile restituire una posizione finale nell'argomento positionSpanEnd. Se il debugger non è in grado di eseguire questa operazione, i valori di riga e colonna nell'intervallo (se richiesto) devono essere impostati su zero.
La riga di testo (o l'intervallo di testo) che rappresenta questa cornice può essere passata facoltativamente dai debugger che lo supportano. Sebbene sia consigliabile che i debugger di script facciano ogni tentativo di restituire questo testo, non è necessario che tali debugger restituiscono più della posizione della riga e della colonna del frame. Se il testo restituito non è supportato, è possibile restituire un nullptr nell'argomento lineText.
Sintassi
HRESULT GetPosition(
ScriptDebugPosition *position,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Parametri
position
Il debugger deve compilare le posizioni di riga e colonna del frame in questo argomento.
positionSpanEnd
Il chiamante può richiedere facoltativamente la fine dell'intervallo di testo che rappresenta questo frame dello stack passando qui un valore non nullptr. Se il debugger può supportare tale richiesta, restituisce le posizioni di riga e colonna qui; in caso contrario, i campi Line and Column della struttura di dati devono essere impostati su zero che indicano che i valori non possono essere determinati.
lineText
Il chiamante può richiedere facoltativamente la riga di codice sorgente (o l'intervallo) che rappresenta la posizione del frame. Se il debugger è in grado di restituire questo valore, deve restituire una stringa allocata dalla funzione SysAllocString. Il chiamante è responsabile della liberazione della stringa allocata con SysFreeString. Se il debugger non è in grado di restituire questo, nullptr deve essere restituito qui.
Valore restituito
Questo metodo restituisce HRESULT che indica l'esito positivo o l'errore.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | dbgmodel.h |