IDebugBreakpoint2::GetOffsetExpression-Methode (dbgeng.h)

Die GetOffsetExpression- Methoden geben die Ausdruckszeichenfolge zurück, die an die 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 die Position des Ziels ausgewertet wird, die den Haltepunkt auslöst. Wenn Puffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

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

[out, optional] ExpressionSize

Die Größe der Ausdruckszeichenfolge in Zeichen. Wenn ExpressionSize-NULL-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 halten, und daher wurde die Zeichenfolge abgeschnitten.

 

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

Bemerkungen

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 Haltepunktkennzeichnungen und Parametern.)

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

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

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	dbgeng.h (include Dbgeng.h)