IDataModelScriptDebug2::GetCurrentPosition-Methode (dbgmodel.h)
Die GetCurrentPosition'-Methode gibt die aktuelle Position innerhalb des Skripts zurück. Dies kann nur aufgerufen werden, wenn das Skript in den Debugger unterteilt wird, bei dem 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 Bereich von Zeichen definiert. Der Anfang der Spanne muss immer zurückgegeben werden (sowohl die Zeilen- als auch die Spaltennummern). Wenn der jeweilige 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 dies nicht unterstützt, sollten die Zeilen- und Spaltenwerte im Bereichsende (falls angefordert) auf Null festgelegt werden.
Wenn der Debugger den Quellcode für die Codezeile übergeben kann, in der der Debugger unterbrochen ist, kann er diese Methode zurückgeben. Wenn möglich, wird dringend empfohlen, diese Informationen bereitzustellen. Es besteht jedoch keine Anforderung, dass mehr Informationen als die Startzeile und Spalte der Umbruchposition zurückgegeben werden. Wenn Quellzeileninformationen nicht unterstützt werden, kann für dieses Argument ein Nullptrwert zurückgegeben werden.
Syntax
HRESULT GetCurrentPosition(
ScriptDebugPosition *currentPosition,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Parameter
currentPosition
Die aktuelle Unterbrechungsposition des Skripts muss hier zurückgegeben werden. Die Felder "Zeile" und "Spalte" der zurückgegebenen Struktur basieren auf einer. Ein Nullwert in beiden gibt an, dass die Informationen nicht verfügbar sind.
positionSpanEnd
Wenn der Debugger die gesamte Spanne der Unterbrechungsposition bestimmen kann, kann hier die Endposition der Spanne zurückgegeben werden. Andernfalls sollten Nullwerte in die Felder "Linie" und "Spalte" der zurückgegebenen Struktur ausgefüllt werden.
lineText
Wenn der Debugger den Quellcode für die Zeile (oder die Spanne) des Umbruchs zurückgeben kann, kann dies hier als Zeichenfolge zurückgegeben werden, die von der SysAllocString-Funktion zugewiesen wird. Der Aufrufer ist dafür verantwortlich, die zurückgegebene Zeichenfolge mit SysFreeString freizugeben. Wenn der Debugger nicht in der Lage ist, diese Quellinformationen zu erzeugen, sollte nullptr zurückgegeben werden.
Rückgabewert
Diese Methode gibt HRESULT zurück, das Erfolg oder Fehler angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header- | dbgmodel.h |