IDataModelScriptDebugBreakpoint::GetPosition-Methode (dbgmodel.h)
Die GetPosition-Methode gibt die Position des Haltepunkts innerhalb des Skripts zurück. Der Skriptdebugger muss die Zeile und Spalte im Quellcode zurückgeben, in der sich der Haltepunkt befindet. Wenn dies möglich ist, kann sie auch eine durch den Haltepunkt dargestellte Quellspanne zurückgeben, indem sie eine Endposition ausfüllt, die durch das argument positionSpanEnd definiert ist. Wenn der Debugger diese Spanne nicht produzieren kann und der Aufrufer sie anfordert, sollten die Zeilen- und Spaltenfelder der Endposition der Spanne als Null ausgefüllt werden, die angibt, dass die Werte nicht angegeben werden können.
Der Debugger gibt möglicherweise auch den Text der Zeile (oder Spanne) des Quellcodes zurück, in dem der Haltepunkt im lineText-Argument vorhanden ist. Es wird zwar dringend empfohlen, diesen Wert von Debuggern zurückzugeben, es ist jedoch nicht erforderlich. Nur die Zeilen- und Spaltenposition innerhalb der Quelle sind rückgabewerte erforderlich. Sollte der Debugger nicht in der Lage sein, den Quelltext zu erzeugen, kann nullptr im lineText-Argument zurückgegeben werden.
Syntax
HRESULT GetPosition(
ScriptDebugPosition *position,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Parameter
position
Die Zeilen- und Spaltenposition des Haltepunkts im Quellcode des Skripts muss hier zurückgegeben werden.
positionSpanEnd
Wenn der Debugger in der Lage ist, die durch den Haltepunkt dargestellte Quellspanne zu erzeugen, kann er die Zeilen- und Spaltenpositionen des Endes der Spanne hier zurückgeben. Andernfalls sollten die Werte für Zeile und Spalte der Struktur auf Null festgelegt werden, die angibt, dass die Werte nicht angegeben werden können.
lineText
Wenn der Debugger die Zeile (oder Spanne) des Quellcodes erzeugen kann, der durch den Haltepunkt dargestellt wird, wird hier eine Zeichenfolge zurückgegeben, die über die SysAllocString-Funktion zugewiesen wird. Der Aufrufer ist dafür verantwortlich, die zurückgegebene Zeichenfolge über SysFreeString freizugeben. Wenn der Debugger diesen Quelltext nicht zurückgeben kann, sollte "nullptr" hier zurückgegeben werden.
Rückgabewert
Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | dbgmodel.h |