Метод IDataModelScriptDebug::GetCurrentPosition (dbgmodel.h)

Метод GetCurrentPosition возвращает текущую позицию в скрипте. Это может вызываться только в том случае, если скрипт разбивается на отладчик, где вызов GetScriptState возвращает ScriptDebugBreak. Любой другой вызов этого метода недопустим и завершится ошибкой.

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

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

Синтаксис

HRESULT GetCurrentPosition(
  ScriptDebugPosition *currentPosition,
  ScriptDebugPosition *positionSpanEnd,
  BSTR                *lineText
);

Параметры

currentPosition

Текущая позиция останова скрипта должна быть возвращена здесь. Поля строки и столбца возвращаемой структуры основаны на одном из них. Нулевое значение в любом случае указывает, что информация недоступна.

positionSpanEnd

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

lineText

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

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

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

Требования

См. также

интерфейс IDataModelScriptDebug