IDataModelScriptDebug2::GetCurrentPosition-Methode (dbgmodel.h)
Die GetCurrentPosition-Methode gibt die aktuelle Position im Skript zurück. Dies kann nur aufgerufen werden, wenn das Skript in den Debugger unterteilt ist, wo ein Aufruf von GetScriptState ScriptDebugBreak zurückgeben würde. Jeder andere Aufruf dieser Methode ist ungültig und schlägt fehl.
Die Position des Skripts wird als Spanne von Zeichen definiert. Der Anfang der Spanne muss immer zurückgegeben werden (sowohl die Zeilen- als auch die Spaltennummern). Wenn der bestimmte Debugger in der Lage ist, die gesamte Spanne der "aktuellen Position" innerhalb des Skripts zurückzugeben, kann optional 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 festgelegt werden.
Wenn der Debugger den Quellcode für die Codezeile übergeben kann, in der der Debugger unterbrochen ist, gibt er diese Methode möglicherweise zurück. Wenn möglich, wird dringend empfohlen, diese Informationen bereitzustellen. Es ist jedoch nicht erforderlich, dass mehr Informationen als die Startzeile und Spalte der Umbruchposition zurückgegeben werden. Wenn Die Quellzeileninformationen nicht unterstützt werden, wird möglicherweise ein NULLPTR-Wert für dieses Argument zurückgegeben.
Syntax
HRESULT GetCurrentPosition(
ScriptDebugPosition *currentPosition,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Parameter
currentPosition
Die aktuelle Umbruchposition des Skripts muss hier zurückgegeben werden. Die Felder Zeile und Spalte der zurückgegebenen Struktur basieren jeweils. Ein Nullwert in beiden gibt an, dass die Informationen nicht verfügbar sind.
positionSpanEnd
Wenn der Debugger in der Lage ist, die gesamte Spanne der Unterbrechungsposition zu bestimmen, kann hier die Endposition der Spanne zurückgegeben werden. Andernfalls sollten null Werte in die Felder Zeile und Spalte der zurückgegebenen Struktur eingegeben werden.
lineText
Wenn der Debugger in der Lage ist, den Quellcode für die Zeile (oder die Spanne) des Umbruchs zurückzugeben, kann diese hier als Zeichenfolge zurückgegeben werden, die von der SysAllocString-Funktion zugewiesen wird. Der Aufrufer ist für das Freigeben der zurückgegebenen Zeichenfolge mit SysFreeString verantwortlich. Wenn der Debugger nicht in der Lage ist, diese Quellinformationen zu erstellen, sollte nullptr zurückgegeben werden.
Rückgabewert
Diese Methode gibt HRESULT zurück, das auf Erfolg oder Fehler hinweist.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |