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 eines Durchbruchs befindet, der 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 die Spanne der "Ausführungsposition" innerhalb des Skripts zurückgeben kann, kann eine Endposition im argument positionSpanEnd zurückgegeben werden. Wenn der Debugger dies nicht unterstützt, sollten die Zeilen- und Spaltenwerte im Bereichsende (falls angefordert) auf 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 versuchen, 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 ein nullptr im lineText-Argument 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 des Textbereichs anfordern, der 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 Null festgelegt werden, die angibt, dass die Werte nicht bestimmt werden können.

lineText

Der Aufrufer kann optional die Quellcodezeile (oder die Spannweite) anfordern, die die Frameposition darstellt. Wenn der Debugger dies zurückgeben kann, sollte er hier eine Zeichenfolge zurückgeben, die von der SysAllocString-Funktion zugewiesen wird. Der Aufrufer ist für das Freigeben der zugeordneten Zeichenfolge mit SysFreeString verantwortlich. Wenn der Debugger dies nicht zurückgeben kann, sollte "nullptr" hier zurückgegeben werden.

Rückgabewert

Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt.

Anforderungen

Siehe auch

IDataModelScriptDebugStackFrame-Schnittstelle