Partilhar via


IDebugDocumentPositionOffset2::GetRange

Recupera o intervalo da posição atual do documento.

Sintaxe

public int GetRange(
   ref uint pdwBegOffset,
   ref uint pdwEndOffset
);

Parâmetros

pdwBegOffset
[dentro, fora] Deslocamento para a posição inicial do intervalo. Defina esse parâmetro como um valor nulo se essas informações não forem necessárias.

pdwEndOffset
[dentro, fora] Deslocamento para a posição final do intervalo. Defina esse parâmetro 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 inclua 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