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

Article
02/06/2025

La méthode GetSymbolName retourne le nom d’un symbole dans un groupe de symboles.

Syntaxe

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

Paramètres

[in] Index

Index du symbole dont vous souhaitez le nom. 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

Nom du symbole. Si tampon est NULL, ces informations ne sont pas retournées.

[in] BufferSize

Taille de la mémoire tampon vers laquelle tampon pointe. Cette taille inclut l’espace du caractère de fin « \0 ».

[out, optional] NameSize

Taille du nom 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, le nom du symbole ne correspondait pas à la mémoire tampon référencée par le paramètre Buffer. Par conséquent, un nom tronqué a été retourné.

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

Remarques

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

IDebugSymbolGroup

IDebugSymbolGroup2

Partager via