Метод IDataModelScriptDebugStackFrame::GetPosition (dbgmodel.h)

Метод GetPosition возвращает позицию в скрипте, представленную кадром стека. Этот метод может вызываться только в том случае, если скрипт находится в пределах разрыва, представленного стеком, в котором содержится этот кадр. Позиция строки и столбца в этом кадре всегда возвращается. Если отладчик может возвращать диапазон позиции выполнения в скрипте, конечная позиция может быть возвращена в аргументе positionSpanEnd. Если отладчик не может это сделать, значения строк и столбцов в конце диапазона (если запрошено) должны быть равны нулю.

Строка текста (или диапазон текста), представляющая этот кадр, при необходимости может передаваться отладчиками, поддерживающими его. Хотя настоятельно рекомендуется, чтобы отладчики скриптов каждой попытки вернуть этот текст, не требуется, чтобы такие отладчики возвращали больше, чем положение строки и столбца кадра. Если возвращаемый текст не поддерживается, в аргументе lineText можно вернуть nullptr.

Синтаксис

HRESULT GetPosition(
  ScriptDebugPosition *position,
  ScriptDebugPosition *positionSpanEnd,
  BSTR                *lineText
);

Параметры

position

Отладчик должен заполнить позиции строки и столбца кадра в этом аргументе.

positionSpanEnd

Вызывающий объект может дополнительно запросить конец диапазона текста, представляющего этот кадр стека, передав здесь значение, отличное от nullptr. Если отладчик может поддерживать такой запрос, он возвращает позиции строки и столбца здесь; В противном случае поля строки и столбца структуры данных должны иметь значение нулю, указывающее, что значения не могут быть определены.

lineText

Вызывающий объект может запрашивать строку исходного кода (или диапазон), представляющую позицию кадра. Если отладчик способен возвращать это, он должен вернуться таким образом, как строка, выделенная функцией SysAllocString. Вызывающий объект отвечает за освобождение выделенной строки с помощью SysFreeString. Если отладчик не способен возвращать этот объект, сюда следует вернуть nullptr.

Возвращаемое значение

Этот метод возвращает HRESULT, указывающий на успешность или сбой.

Требования

См. также

интерфейс IDataModelScriptDebugStackFrame