Método IDataModelScriptDebugStackFrame::GetPosition (dbgmodel.h)
O método GetPosition retorna a posição dentro do script representado pelo quadro de pilha. Esse método só pode ser chamado quando o script está dentro de uma quebra representada pela pilha na qual esse quadro está contido. A posição da linha e da coluna dentro desse quadro sempre é retornada. Se o depurador for capaz de retornar o intervalo da "posição de execução" dentro do script, uma posição final poderá ser retornada no argumento positionSpanEnd. Se o depurador não for capaz disso, os valores de linha e coluna na extremidade de intervalo (se solicitado) deverão ser definidos como zero.
A linha de texto (ou o intervalo de texto) que representa esse quadro pode, opcionalmente, ser passada de volta por depuradores que dão suporte a ele. Embora seja altamente recomendável que os depuradores de script façam todas as tentativas de retornar esse texto, não há nenhum requisito de que esses depuradores retornem mais do que a posição de linha e coluna do quadro. Se não houver suporte para o texto de retorno, um nullptr poderá ser retornado no argumento lineText.
Sintaxe
HRESULT GetPosition(
ScriptDebugPosition *position,
ScriptDebugPosition *positionSpanEnd,
BSTR *lineText
);
Parâmetros
position
O depurador deve preencher as posições de linha e coluna do quadro nesse argumento.
positionSpanEnd
Opcionalmente, o chamador pode solicitar o fim do intervalo de texto que representa esse quadro de pilha passando um valor não nullptr aqui. Se o depurador puder dar suporte a essa solicitação, ele retornará as posições de linha e coluna aqui; caso contrário, os campos Linha e Coluna da estrutura de dados devem ser definidos como zero, indicando que os valores não podem ser determinados.
lineText
Opcionalmente, o chamador pode solicitar a linha do código-fonte (ou o intervalo) que representa a posição do quadro. Se o depurador for capaz de retornar isso, ele deverá retornar como uma cadeia de caracteres alocada pela função SysAllocString. O chamador é responsável por liberar a cadeia de caracteres alocada com SysFreeString. Se o depurador não for capaz de retornar isso, nullptr deverá ser retornado aqui.
Retornar valor
Esse método retorna HRESULT que indica êxito ou falha.
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | dbgmodel.h |