Método IDataModelScriptDebug::GetCurrentPosition (dbgmodel.h)
O método GetCurrentPosition' retorna a posição atual dentro do script. Isso só pode ser chamado quando o script é dividido no depurador em que uma chamada para GetScriptState retornaria ScriptDebugBreak. Qualquer outra chamada para esse método é inválida e falhará.
A posição do script é definida como um intervalo de caracteres. O início do intervalo sempre deve ser retornado (os números de linha e coluna). Se o depurador específico for capaz de retornar o intervalo completo da "posição atual" dentro do script, uma posição final poderá ser retornada opcionalmente no argumento positionSpanEnd. Se o depurador não for capaz disso, os valores de linha e coluna na extremidade do intervalo (se solicitado) deverão ser definidos como zero.
Se o depurador puder passar o código-fonte para a linha de código em que o depurador está quebrado, ele poderá retornar isso desse método. Se possível, é altamente recomendável fornecer essas informações. No entanto, não há nenhum requisito de que mais informações do que a linha inicial e a coluna da posição de interrupção sejam retornadas. Se não houver suporte para informações de linha de origem, um valor nullptr poderá ser retornado para esse argumento.
Sintaxe
HRESULT GetCurrentPosition(
ScriptDebugPosition *currentPosition,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Parâmetros
currentPosition
A posição de interrupção atual do script deve ser retornada aqui. Os campos Linha e Coluna da estrutura retornada são baseados em um. Um valor zero em indica que as informações não estão disponíveis.
positionSpanEnd
Se o depurador for capaz de determinar o intervalo completo da posição de interrupção, a posição final do intervalo poderá ser retornada aqui. Caso contrário, zero valores deverão ser preenchidos nos campos Linha e Coluna da estrutura retornada.
lineText
Se o depurador for capaz de retornar o código-fonte para a linha (ou o intervalo) da quebra, isso poderá ser retornado aqui como uma cadeia de caracteres alocada pela função SysAllocString. O chamador é responsável por liberar a cadeia de caracteres retornada com SysFreeString. Se o depurador não puder produzir essas informações de origem, nullptr deverá ser retornado.
Retornar valor
Esse método retorna HRESULT que indica êxito ou falha.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | dbgmodel.h |