IDebugDocumentPosition2::GetRange
Ruft den Bereich für diese Dokumentposition ab.
Syntax
Parameter
pBegPosition
[in, out] Eine TEXT_POSITION Struktur, die mit der Anfangsposition gefüllt ist. Legen Sie dieses Argument auf einen Nullwert fest, wenn diese Informationen nicht benötigt werden.
pEndPosition
[in, out] Eine TEXT_POSITION Struktur, die mit der Endposition gefüllt ist. Legen Sie dieses Argument auf einen Nullwert fest, wenn diese Informationen nicht benötigt werden.
Rückgabewert
Wenn die Ausführung erfolgreich ist, wird S_OK
, andernfalls ein Fehlercode zurückgegeben.
Hinweise
Der in einer Dokumentposition für einen Ortsumbruchpunkt angegebene Bereich wird vom Debugmodul (DE) verwendet, um nach einer Anweisung zu suchen, die tatsächlich Code beiträgt. Stellen Sie sich beispielsweise den folgende Code vor:
Line 5: // comment
Line 6: x = 1;
Zeile 5 trägt keinen Code zum Debuggen des Programms bei. Wenn der Debugger, der den Haltepunkt in Zeile 5 festlegt, möchte, dass die DE eine bestimmte Menge für die erste Zeile weitersucht, die Code beiträgt, würde der Debugger einen Bereich angeben, der zusätzliche Kandidatenzeilen enthält, in denen ein Haltepunkt möglicherweise ordnungsgemäß platziert ist. Die DE durchsucht diese Zeilen dann vorwärts, bis sie eine Zeile gefunden hat, die einen Haltepunkt akzeptieren konnte.