IDebugDocumentPosition2::GetRange
Obtient la plage de cette position de document.
Syntaxe
Paramètres
pBegPosition
[in, out] Structure TEXT_POSITION remplie à la position de départ. Définissez cet argument sur une valeur Null si ces informations ne sont pas nécessaires.
pEndPosition
[in, out] Structure TEXT_POSITION remplie avec la position de fin. Définissez cet argument sur une valeur Null si ces informations ne sont pas nécessaires.
Valeur de retour
En cas de réussite, retourne S_OK
, sinon, retourne un code d'erreur.
Notes
La plage spécifiée dans une position de document pour un point d’arrêt d’emplacement est utilisée par le moteur de débogage (DE) pour rechercher à l’avance une instruction qui contribue réellement au code. Considérons par exemple le code suivant :
Line 5: // comment
Line 6: x = 1;
La ligne 5 ne contribue à aucun code au programme en cours de débogage. Si le débogueur qui définit le point d’arrêt sur la ligne 5 souhaite que le DE effectue une recherche vers l’avant pour la première ligne qui contribue au code, le débogueur spécifie une plage qui inclut des lignes candidates supplémentaires où un point d’arrêt peut être correctement placé. Le DE effectuerait ensuite une recherche vers l’avant dans ces lignes jusqu’à ce qu’elle trouve une ligne qui pouvait accepter un point d’arrêt.