Partager via

IDebugDocumentPositionOffset2::GetRange

  • Article

Récupère la plage pour la position actuelle du document.

Syntaxe

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

Paramètres

pdwBegOffset
[in, out] Décalage pour la position de début de la plage. Définissez ce paramètre sur une valeur Null si ces informations ne sont pas nécessaires.

pdwEndOffset
[in, out] Décalage pour la position de fin de la plage. Définissez ce paramètre 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