IDebugDocumentPosition2::GetRange

  • Article

Obtient la plage de cette position de document.

Syntaxe

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

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.

Voir aussi