Método IDataModelScriptDebugBreakpoint::GetPosition (dbgmodel.h)
O método GetPosition retorna a posição do ponto de interrupção dentro do script. O depurador de script deve retornar a linha e a coluna no código-fonte em que o ponto de interrupção está localizado. Se for capaz de fazer isso, ele também poderá retornar um intervalo de origem representado pelo ponto de interrupção preenchendo uma posição final, conforme definido pelo argumento positionSpanEnd. Se o depurador não for capaz de produzir esse intervalo e o chamador solicitá-lo, os campos Linha e Coluna da posição final do intervalo deverão ser preenchidos como zero indicando que os valores não podem ser fornecidos.
O depurador também pode retornar o texto da linha (ou intervalo) do código-fonte em que o ponto de interrupção existe no argumento lineText. Embora seja altamente recomendável que os depuradores retornem esse valor, ele não é necessário. Somente a posição de linha e coluna dentro da origem são necessários valores de retorno. Se o depurador não puder produzir o texto de origem, nullptr poderá ser retornado no argumento lineText.
Sintaxe
HRESULT GetPosition(
ScriptDebugPosition *position,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Parâmetros
position
A posição de linha e coluna do ponto de interrupção dentro do código-fonte do script deve ser retornada aqui.
positionSpanEnd
Se o depurador for capaz de produzir o intervalo de origem representado pelo ponto de interrupção, ele poderá retornar as posições de linha e coluna do final do intervalo aqui. Caso contrário, os valores de Linha e Coluna da estrutura devem ser definidos como zero indicando que os valores não podem ser fornecidos.
lineText
Se o depurador puder produzir a linha (ou intervalo) do código-fonte representado pelo ponto de interrupção, ele retornará aqui como uma cadeia de caracteres alocada por meio da função SysAllocString. O chamador é responsável por liberar a cadeia de caracteres retornada por meio de SysFreeString. Se o depurador não for capaz de retornar esse texto de origem, nullptr deverá ser retornado aqui.
Valor de retorno
Esse método retorna HRESULT que indica êxito ou falha.
Requisitos
| Requisito | Valor |
|---|---|
| cabeçalho | dbgmodel.h |