Compartilhar via


IDebugDocumentPosition2::GetRange

Obtém o intervalo para esta posição do documento.

Sintaxe

int GetRange( 
   TEXT_POSITION[] pBegPosition,
   TEXT_POSITION[] pEndPosition
);

Parâmetros

pBegPosition
[dentro, fora] Uma estrutura TEXT_POSITION que é preenchida com a posição inicial. Defina esse argumento como um valor nulo se essas informações não forem necessárias.

pEndPosition
[dentro, fora] Uma estrutura TEXT_POSITION que é preenchida com a posição final. Defina esse argumento como um valor nulo se essas informações não forem necessárias.

Valor de retorno

Se tiver êxito, retornará S_OK. Caso contrário, retornará um código de erro.

Comentários

O intervalo especificado em uma posição de documento para um ponto de interrupção de local é usado pelo mecanismo de depuração (DE) para procurar antecipadamente uma instrução que realmente contribua com código. Por exemplo, considere o seguinte código:

Line 5: // comment
Line 6: x = 1;

A linha 5 não contribui com nenhum código para o programa que está sendo depurado. Se o depurador que define o ponto de interrupção na linha 5 quiser que o DE pesquise uma determinada quantidade para a primeira linha que contribui com código, o depurador especificará um intervalo que inclui linhas candidatas adicionais onde um ponto de interrupção pode ser colocado corretamente. O DE então procurava essas linhas até encontrar uma linha que pudesse aceitar um ponto de interrupção.

Confira também