IDebugSymbolGroup2 ::GetSymbolValueText, méthode (dbgeng.h)

Article
02/06/2025

La méthode GetSymbolValueText retourne une chaîne qui représente la valeur d’un symbole.

Syntaxe

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

Paramètres

[in] Index

Index du symbole dont vous souhaitez obtenir la valeur. L’index d’un symbole est un numéro d’identification. L’index est compris entre zéro et le nombre de symboles dans le groupe de symboles moins un.

[out, optional] Buffer

Valeur du symbole sous forme de chaîne. Si tampon est NULL, ces informations ne sont pas retournées.

[in] BufferSize

Taille, en caractères, de la mémoire tampon tampon . Cette taille inclut l’espace du caractère de fin « \0 ».

[out, optional] NameSize

Taille, en caractères, de la valeur du symbole. Cette taille inclut l’espace du caractère de fin « \0 ». Si NameSize est NULL, ces informations ne sont pas retournées.

Valeur de retour

Retourner le code	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, la valeur du symbole ne tient pas dans la mémoire tampon référencée par le paramètre tampon, de sorte qu’une valeur tronquée a été retournée.

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

Remarques

Si vous avez ajouté le symbole au groupe de symboles à l’aide de la méthode AddSymbol, la chaîne retournée à Tampon est le nom du symbole passé à AddSymbol.

Pour plus d’informations sur les groupes de symboles, consultez Étendues et groupes de symboles.

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include Dbgeng.h)

Voir aussi

GetNumberSymbols

IDebugSymbolGroup2

WriteSymbol

Partager via