Méthode IDebugSymbolGroup2 ::GetSymbolValueText (dbgeng.h)

Article
02/23/2024

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 Buffer a la valeur NULL, ces informations ne sont pas retournées.

[in] BufferSize

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

[out, optional] NameSize

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

Valeur retournée

Code de retour	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 Buffer . Une valeur tronquée a donc é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 à Buffer est le nom du symbole passé à AddSymbol.

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