IDebugBreakpoint2::GetOffsetExpression-Methode (dbgeng.h)

  • Artikel

Die GetOffsetExpression-Methoden geben die Ausdruckszeichenfolge zurück, die an der Position ausgewertet wird, die einen Haltepunkt auslöst.

Syntax

HRESULT GetOffsetExpression(
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG ExpressionSize
);

Parameter

[out, optional] Buffer

Die Ausdruckszeichenfolge, die an der Position auf dem Ziel ausgewertet wird, die den Haltepunkt auslöst. Wenn PufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Die Größe des Puffers, auf den Puffer verweist, in Zeichen.

[out, optional] ExpressionSize

Die Größe der Ausdruckszeichenfolge in Zeichen. Wenn ExpressionSizeNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode war erfolgreich.
S_FALSE
 Die Methode war erfolgreich, aber der Puffer war nicht groß genug, um die Ausdruckszeichenfolge zu enthalten, sodass die Zeichenfolge so abgeschnitten wurde, dass sie passt.
 

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Hinweise

Der Ausdruck wird jedes Mal ausgewertet, wenn ein Modul geladen oder entladen wird. Wenn der Debugger den Ausdruck nicht auswerten kann (z. B. wenn der Ausdruck ein Symbol enthält, das nicht interpretiert werden kann), wird der Haltepunkt als verzögert gekennzeichnet. (Weitere Informationen zu verzögerten Haltepunkten finden Sie unter Steuern von Breakpointflags und -parametern.)

Die GetParameters-Methode gibt auch die Größe der Ausdruckszeichenfolge zurück, die den Speicherort angibt, der den Breakpoint ExpressionSize auslöst.

Weitere Informationen zur Verwendung von Haltepunkten finden Sie unter Verwenden von Haltepunkten.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dbgeng.h (einschließlich Dbgeng.h)