Método IDataModelScriptDebugStackFrame::GetPosition (dbgmodel.h)
El método GetPosition devuelve la posición dentro del script representado por el marco de pila. Solo se puede llamar a este método cuando el script está dentro de un salto representado por la pila en la que se encuentra este marco. La posición de línea y columna dentro de este marco siempre se devuelve. Si el depurador es capaz de devolver el intervalo de la "posición de ejecución" dentro del script, 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.
Opcionalmente, los depuradores que lo admiten pueden volver a pasar la línea de texto (o el intervalo de texto) que representa este marco. Aunque se recomienda encarecidamente que los depuradores de scripts realicen todos los intentos de devolver este texto, no es necesario que dichos depuradores devuelvan más que la posición de línea y columna del marco. Si no se admite el texto devuelto, se puede devolver un nullptr en el argumento lineText.
Sintaxis
HRESULT GetPosition(
ScriptDebugPosition *position,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Parámetros
position
El depurador debe rellenar las posiciones de línea y columna del marco en este argumento.
positionSpanEnd
Opcionalmente, el autor de la llamada puede solicitar el final del intervalo de texto que representa este marco de pila pasando aquí un valor que no sea nullptr. Si el depurador puede admitir dicha solicitud, devuelve las posiciones de línea y columna aquí; de lo contrario, los campos Línea y Columna de la estructura de datos deben establecerse en cero, lo que indica que no se pueden determinar los valores.
lineText
Opcionalmente, el autor de la llamada puede solicitar la línea de código fuente (o el intervalo) que representa la posición del marco. Si el depurador es capaz de devolver esto, debe devolverlo aquí como una cadena asignada por la función SysAllocString. El autor de la llamada es responsable de liberar la cadena asignada con SysFreeString. Si el depurador no es capaz de devolver esto, se debe devolver nullptr aquí.
Valor devuelto
Este método devuelve HRESULT, que indica que se ha realizado correctamente o no.
Requisitos
| Requisito | Valor |
|---|---|
| Header | dbgmodel.h |