IDataModelScriptDebugStackFrame::GetPosition-Methode (dbgmodel.h)
Die GetPosition-Methode gibt die Position innerhalb des Skripts zurück, das durch den Stapelrahmen dargestellt wird. Diese Methode kann nur aufgerufen werden, wenn sich das Skript innerhalb einer Unterbrechung befindet, die durch den Stapel dargestellt wird, in dem dieser Frame enthalten ist. Die Zeilen- und Spaltenposition innerhalb dieses Frames wird immer zurückgegeben. Wenn der Debugger in der Lage ist, die Spanne der "Ausführungsposition" innerhalb des Skripts zurückzugeben, kann eine Endposition im argument positionSpanEnd zurückgegeben werden. Wenn der Debugger dazu nicht in der Lage ist, sollten die Zeilen- und Spaltenwerte im Span-Ende (falls angefordert) auf 0 (null) festgelegt werden.
Die Textzeile (oder die Textspanne), die diesen Frame darstellt, kann optional von Debuggern zurückgegeben werden, die ihn unterstützen. Es wird zwar dringend empfohlen, dass Skriptdebugger jeden Versuch unternehmen, diesen Text zurückzugeben, es ist jedoch nicht erforderlich, dass solche Debugger mehr als die Zeilen- und Spaltenposition des Frames zurückgeben. Wenn rückgabetext nicht unterstützt wird, kann im argument lineText ein nullptr zurückgegeben werden.
Syntax
HRESULT GetPosition(
ScriptDebugPosition *position,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Parameter
position
Der Debugger sollte die Zeilen- und Spaltenpositionen des Frames in diesem Argument ausfüllen.
positionSpanEnd
Der Aufrufer kann optional das Ende der Textspanne anfordern, die diesen Stapelrahmen darstellt, indem er hier einen Wert ohne Nullptr übergibt. Wenn der Debugger eine solche Anforderung unterstützen kann, gibt er hier die Zeilen- und Spaltenpositionen zurück. Andernfalls sollten die Felder Zeile und Spalte der Datenstruktur auf 0 festgelegt werden, was angibt, dass die Werte nicht bestimmt werden können.
lineText
Der Aufrufer kann optional die Quellcodezeile (oder die Spanne) anfordern, die die Frameposition darstellt. Wenn der Debugger dies zurückgeben kann, sollte er hier eine Zeichenfolge zurückgeben, die von der SysAllocString-Funktion zugeordnet wird. Der Aufrufer ist für das Freigeben der zugeordneten Zeichenfolge mit SysFreeString verantwortlich. Wenn der Debugger dies 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 |