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

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

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

Синтаксис

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

Параметры

position

Здесь необходимо вернуть позицию строки и столбца точки останова в исходном коде скрипта.

positionSpanEnd

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

lineText

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

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

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

Требования

См. также

интерфейс IDataModelScriptDebugBreakpoint