Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il metodo GetCurrentPosition restituisce la posizione corrente all'interno dello script. Questa operazione può essere chiamata solo quando lo script viene suddiviso nel debugger in cui una chiamata a GetScriptState restituirà ScriptDebugBreak. Qualsiasi altra chiamata a questo metodo non è valida e avrà esito negativo.
La posizione dello script è definita come intervallo di caratteri. L'inizio dell'intervallo deve essere sempre restituito (sia la riga che i numeri di colonna). Se il debugger specifico è in grado di restituire l'intervallo completo della "posizione corrente" all'interno dello script, è possibile restituire facoltativamente una posizione finale nell'argomento positionSpanEnd. Se il debugger non è in grado di eseguire questa operazione, i valori di riga e colonna nell'estremità dell'intervallo (se richiesto) devono essere impostati su zero.
Se il debugger può passare il codice sorgente per la riga di codice in cui il debugger è interrotto, può restituire tale codice da questo metodo. Se possibile, è vivamente consigliabile fornire queste informazioni. Non è tuttavia necessario che vengano restituite altre informazioni rispetto alla riga iniziale e alla colonna della posizione di interruzione. Se le informazioni sulla riga di origine non sono supportate, è possibile che per tale argomento venga restituito un valore nullptr.
Sintassi
HRESULT GetCurrentPosition(
ScriptDebugPosition *currentPosition,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Parametri
currentPosition
La posizione di interruzione corrente dello script deve essere restituita qui. I campi Riga e Colonna della struttura restituita sono basati su uno. Un valore zero in indica che le informazioni non sono disponibili.
positionSpanEnd
Se il debugger è in grado di determinare l'intervallo completo della posizione dell'interruzione, è possibile restituire qui la posizione finale dell'intervallo. In caso contrario, i valori zero devono essere compilati nei campi Riga e Colonna della struttura restituita.
lineText
Se il debugger è in grado di restituire il codice sorgente per la riga (o l'intervallo) dell'interruzione, è possibile restituire qui come stringa allocata dalla funzione SysAllocString. Il chiamante è responsabile della liberazione della stringa restituita con SysFreeString. Se il debugger non è in grado di produrre queste informazioni di origine, deve essere restituito nullptr.
Valore restituito
Questo metodo restituisce HRESULT che indica l'esito positivo o negativo.
Fabbisogno
Requisito | Valore |
---|---|
intestazione | dbgmodel.h |