IDebugSymbolGroup2::GetSymbolValueText-Methode (dbgeng.h)

Artikel
02/06/2025

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 verwenden 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 Puffer-NULL-ist, werden diese Informationen nicht zurückgegeben.

[in] BufferSize

Die Größe des Puffer-Puffers in Zeichen. Diese Größe enthält den Abstand für das Endzeichen '\0'.

[out, optional] NameSize

Die Größe des Symbols in Zeichen. Diese Größe enthält den Abstand für das Endzeichen '\0'. Wenn NameSize-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. Der Wert des Symbols würde jedoch nicht in den Puffer passen, auf den der parameter Buffer verweist, sodass ein abgeschnittener Wert zurückgegeben wurde.

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

Bemerkungen

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

Weitere Informationen zu Symbolgruppen finden Sie unter Bereiche und Symbolgruppen.