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 auch eine Quellspanne zurückgegeben werden, die durch den Haltepunkt dargestellt wird, indem eine Durch das argument positionSpanEnd definierte Endposition ausgefüllt wird. Wenn der Debugger diese Spanne nicht erzeugen kann und der Aufrufer sie anfordert, sollten die Felder Zeile und Spalte der Endposition der Spanne als null ausgefüllt werden, was angibt, dass die Werte nicht angegeben werden können.
Der Debugger kann auch den Text der Zeile (oder Spanne) des Quellcodes zurückgeben, in der der Haltepunkt im argument lineText vorhanden ist. Es wird zwar dringend empfohlen, dass Debugger diesen Wert zurückgeben, aber er ist nicht erforderlich. Nur die Zeilen- und Spaltenposition innerhalb der Quelle sind rückgabewerte erforderlich. Wenn der Debugger nicht in der Lage ist, den Quelltext zu erzeugen, kann nullptr im argument lineText 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 hier die Zeilen- und Spaltenpositionen des Endes der Spanne zurückgeben. Andernfalls sollten die Line- und Column-Werte der -Struktur auf Null festgelegt werden, was angibt, dass die Werte nicht angegeben werden können.
lineText
Wenn der Debugger die durch den Haltepunkt dargestellte Zeile (oder Spanne) des Quellcodes erzeugen kann, gibt er hier eine Zeichenfolge zurück, die über die SysAllocString-Funktion zugeordnet ist. Der Aufrufer ist dafür verantwortlich, die zurückgegebene Zeichenfolge über SysFreeString freizugeben. Wenn der Debugger diesen Quelltext nicht zurückgeben kann, sollte hier nullptr zurückgegeben werden.
Rückgabewert
Diese Methode gibt HRESULT zurück, das den Erfolg oder Fehler angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |