IDebugSymbolGroup2::GetSymbolValueText-Methode (dbgeng.h)

Artikel
02/26/2024

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

Syntax

HRESULT GetSymbolValueText(
  [in]            ULONG  Index,
  [out, optional] PSTR   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 BufferNULL ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

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

[out, optional] NameSize

Die Größe des Werts des Symbols in Zeichen. Diese Größe enthält den Leerraum 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 der Symbolgruppe mithilfe der AddSymbol-Methode 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.