IDebugDocumentPositionOffset2::GetRangeIDebugDocumentPositionOffset2::GetRange

Récupère la plage pour la position actuelle du document.Retrieves the range for the current document position.

SyntaxeSyntax

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

ParamètresParameters

pdwBegOffset
[dans, out] Décalage de la position de début de la plage.[in, out] Offset for the start position of the range. Définissez ce paramètre sur une valeur null si cette information n’est pas nécessaire.Set this parameter to a null value if this information is not needed.

pdwEndOffset
[dans, out] Décalage de la position de fin de la plage.[in, out] Offset for the end position of the range. Définissez ce paramètre sur une valeur null si cette information n’est pas nécessaire.Set this parameter to a null value if this information is not needed.

Valeur de retourReturn Value

En cas de réussite, retourne S_OK; sinon, retourne un code d’erreur.If successful, returns S_OK; otherwise, returns an error code.

NotesRemarks

La plage spécifiée dans un emplacement de document pour un point d’arrêt d’emplacement est utilisée par le moteur de débogage (DE) pour rechercher directement une instruction qui apporte réellement le code.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. Considérons par exemple le code suivant :For example, consider the following code:

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

La ligne 5 ne contribue aucun code pour le programme en cours de débogage.Line 5 contributes no code to the program being debugged. Si le débogueur qui définit le point d’arrêt à la ligne 5 veut le DE pour une recherche à une certaine quantité de la première ligne qui contribue le code, le débogueur spécifiez une plage qui comprend des lignes de candidat supplémentaire dans lequel un point d’arrêt peut être placé correctement.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. Le DE puis recherche vers l’avant à travers les lignes jusqu'à ce qu’il trouve une ligne qui peut accepter un point d’arrêt.The DE would then search forward through those lines until it found a line that could accept a breakpoint.

Voir aussiSee Also

IDebugDocumentPositionOffset2 IDebugDocumentPositionOffset2
GetRangeGetRange