Compartir a través de


Método IDataModelScriptDebug2::GetCurrentPosition (dbgmodel.h)

El método GetCurrentPosition devuelve la posición actual dentro del script. Esto solo se puede llamar cuando el script se divide en el depurador donde una llamada a GetScriptState devolvería ScriptDebugBreak. Cualquier otra llamada a este método no es válida y producirá un error.

La posición del script se define como un intervalo de caracteres. Siempre se debe devolver el inicio del intervalo (los números de línea y columna). Si el depurador concreto es capaz de devolver el intervalo completo de la "posición actual" dentro del script, opcionalmente se puede devolver una posición final en el argumento positionSpanEnd. Si el depurador no es capaz de ello, los valores de línea y columna del extremo del intervalo (si se solicita) deben establecerse en cero.

Si el depurador puede pasar el código fuente de la línea de código donde se interrumpe el depurador, puede devolverlo de este método. Si es posible, se recomienda encarecidamente proporcionar esta información. Sin embargo, no es necesario que se devuelva más información que la línea inicial y la columna de la posición de interrupción. Si no se admite la información de línea de origen, se puede devolver un valor nullptr para ese argumento.

Sintaxis

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

Parámetros

currentPosition

La posición de interrupción actual del script debe devolverse aquí. Los campos Línea y Columna de la estructura devuelta se basan en uno. Un valor cero en indica que la información no está disponible.

positionSpanEnd

Si el depurador es capaz de determinar el intervalo completo de la posición de interrupción, la posición final del intervalo se puede devolver aquí. Si no es así, se deben rellenar cero valores en los campos Línea y Columna de la estructura devuelta.

lineText

Si el depurador es capaz de devolver el código fuente de la línea (o el intervalo) de la interrupción, puede devolverse aquí como una cadena asignada por la función SysAllocString. El autor de la llamada es responsable de liberar la cadena devuelta con SysFreeString. Si el depurador no puede generar esta información de origen, se debe devolver nullptr.

Valor devuelto

Este método devuelve HRESULT que indica éxito o error.

Requisitos

Requisito Valor
Header dbgmodel.h

Consulte también

Interfaz IDataModelScriptDebug2