IDebugSymbolGroup2::GetSymbolValueTextWide-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetSymbolValueTextWide-Methode gibt eine Zeichenfolge zurück, die den Wert eines Symbols darstellt.

Syntax

HRESULT GetSymbolValueTextWide(
  [in]            ULONG  Index,
  [out, optional] PWSTR  Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG NameSize
);

Parameter

[in] Index

Der Index des Symbols, dessen Wert Sie möchten. Der Index eines Symbols ist eine Identifikationsnummer. Der Index reicht von null bis zur Anzahl der Symbole in der Symbolgruppe minus 1.

[out, optional] Buffer

Der Wert des Symbols als Zeichenfolge. Wenn PufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Die Größe des Pufferpuffers in Zeichen. Diese Größe enthält den Platz für das "\0"-Endzeichen.

[out, optional] NameSize

Die Größe des Werts des Symbols in Zeichen. Diese Größe enthält den Platz für das "\0"-Endzeichen. Wenn NameSizeNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.
S_FALSE	Die Methode war erfolgreich. Der Wert des Symbols würde jedoch nicht in den Puffer passen, auf den der Buffer-Parameter verweist, sodass ein abgeschnittener Wert zurückgegeben wurde.

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

Hinweise

Wenn Sie das Symbol mithilfe der AddSymbol-Methode der Symbolgruppe hinzugefügt haben, ist die an Buffer zurückgegebene Zeichenfolge der Name des Symbols, das an AddSymbol übergeben wird.

Weitere Informationen zu Symbolgruppen finden Sie unter Bereiche und Symbolgruppen.