IDebugDocumentPositionOffset2::GetRangeIDebugDocumentPositionOffset2::GetRange

Recupera el intervalo de la posición del documento actual.Retrieves the range for the current document position.

SintaxisSyntax

HRESULT GetRange(  
   DWORD* pdwBegOffset,  
   DWORD* pdwEndOffset  
);  
public int GetRange(  
   ref uint pdwBegOffset,  
   ref uint pdwEndOffset  
);  

ParámetrosParameters

pdwBegOffset
[entrada, salida] Desplazamiento de la posición inicial del intervalo.[in, out] Offset for the start position of the range. Establezca este parámetro en un valor null si no se necesita esta información.Set this parameter to a null value if this information is not needed.

pdwEndOffset
[entrada, salida] Desplazamiento de la posición final del intervalo.[in, out] Offset for the end position of the range. Establezca este parámetro en un valor null si no se necesita esta información.Set this parameter to a null value if this information is not needed.

Valor devueltoReturn Value

Si se realiza correctamente, devuelve S_OK; en caso contrario, devuelve un código de error.If successful, returns S_OK; otherwise, returns an error code.

ComentariosRemarks

El intervalo especificado en una posición del documento para un punto de interrupción se utiliza por el motor de depuración (Alemania) para buscar una instrucción que realmente contribuye código con antelación.The range specified in a document position for a location breakpoint is used by the debug engine (DE) to search ahead for a statement that actually contributes code. Por ejemplo, considere el siguiente código:For example, consider the following code:

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

Línea 5 no contribuye ningún código para el programa que se está depurando.Line 5 contributes no code to the program being debugged. Si el depurador, que establece el punto de interrupción en la línea 5 desea que la DE buscar hacia delante una cierta cantidad de la primera línea que aporta código, el depurador debería especificar un intervalo que incluya las líneas de candidato adicional donde se puede colocar correctamente un punto de interrupción.If the debugger that sets the breakpoint on line 5 wants the DE to search forward a certain amount for the first line that contributes code, the debugger would specify a range that includes additional candidate lines where a breakpoint might be correctly placed. La DE, a continuación, podría buscar hacia delante a través de las líneas hasta que encuentre una línea que podría aceptar un punto de interrupción.The DE would then search forward through those lines until it found a line that could accept a breakpoint.

Vea tambiénSee Also

IDebugDocumentPositionOffset2 IDebugDocumentPositionOffset2
GetRangeGetRange