IDataModelScriptDebug::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 wird, wobei ein Aufruf von GetScriptState ScriptDebugBreak zurückgibt. 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 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 dazu nicht in der Lage ist, sollten die Zeilen- und Spaltenwerte im Span-Ende (falls angefordert) auf 0 (null) festgelegt werden.
Wenn der Debugger den Quellcode für die Codezeile übergeben kann, in der der Debugger unterbrochen ist, kann er eine solche von dieser Methode zurückgeben. 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 Quellzeileninformationen nicht unterstützt werden, kann für dieses Argument ein Nullptr-Wert zurückgegeben werden.
Syntax
HRESULT GetCurrentPosition(
ScriptDebugPosition *currentPosition,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Parameter
currentPosition
Die aktuelle Halteposition des Skripts muss hier zurückgegeben werden. Die Felder Zeile und Spalte der zurückgegebenen Struktur sind eins basierend. Der Wert 0 (null) in 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 von der SysAllocString-Funktion zugeordnete Zeichenfolge zurückgegeben werden. 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 erzeugen, sollte nullptr zurückgegeben werden.
Rückgabewert
Diese Methode gibt HRESULT zurück, das den Erfolg oder Fehler angibt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | dbgmodel.h |