IDebugBreakpoint2::GetOffsetExpressionWide-Methode (dbgeng.h)

Die GetOffsetExpressionWide-Methode gibt die Ausdruckszeichenfolge zurück, die an der Position ausgewertet wird, die einen Haltepunkt auslöst.

Syntax

HRESULT GetOffsetExpressionWide(
  [out, optional] PWSTR  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)