Метод IDataModelScriptDebugStackFrame::GetPosition (dbgmodel.h)
Метод GetPosition возвращает позицию в скрипте, представленную кадром стека. Этот метод можно вызывать только в том случае, если скрипт находится в пределах разрыва, представленного стеком, в котором содержится этот кадр. Позиция строки и столбца в этом кадре всегда возвращается. Если отладчик может возвращать диапазон "позиции выполнения" в скрипте, в аргументе positionSpanEnd может быть возвращена конечная позиция. Если отладчик не поддерживает эту функцию, значения строк и столбцов в конце диапазона (при запросе) должны быть равны нулю.
Строка текста (или диапазон текста), представляющая этот кадр, при необходимости может быть передана обратно отладчиками, которые его поддерживают. Хотя настоятельно рекомендуется, чтобы отладчики скриптов предпринимали все попытки вернуть этот текст, не требуется, чтобы такие отладчики возвращали больше, чем позиции строки и столбца кадра. Если возвращаемый текст не поддерживается, в аргументе lineText можно вернуть значение nullptr.
Синтаксис
HRESULT GetPosition(
ScriptDebugPosition *position,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Параметры
position
Отладчик должен заполнить позиции строк и столбцов кадра в этом аргументе.
positionSpanEnd
При необходимости вызывающий объект может запросить конец диапазона текста, представляющего этот кадр стека, передав здесь значение, отличное от nullptr. Если отладчик может поддерживать такой запрос, он возвращает здесь позиции строк и столбцов; В противном случае полям Строка и Столбец структуры данных следует задать нулевое значение, указывающее, что значения не могут быть определены.
lineText
При необходимости вызывающий объект может запросить строку исходного кода (или диапазон), представляющую позицию кадра. Если отладчик способен возвращать это значение, он должен возвращать строку, выделенную функцией SysAllocString. Вызывающий объект отвечает за освобождение выделенной строки с помощью SysFreeString. Если отладчик не может возвращать это значение, здесь должен быть возвращен nullptr.
Возвращаемое значение
Этот метод возвращает HRESULT, который указывает на успех или сбой.
Требования
| Требование | Значение |
|---|---|
| Заголовок | dbgmodel.h |