IDebugBreakpoint::GetOffsetExpression-Methode (dbgeng.h)

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 zu der Position auf dem Ziel ausgewertet wird, die den Haltepunkt auslöst. Wenn BufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Die Größe des Puffers in Zeichen, auf den Buffer zeigt.

[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 entsprechend abgeschnitten wurde.

 

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 Haltepunkt ExpressionSize auslöst.

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

Anforderungen

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