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

Article
02/23/2024

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

Syntaxe

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

Paramètres

[in] Index

Index du symbole dont vous souhaitez obtenir 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 La mémoire tampon a la valeur NULL, ces informations ne sont pas retournées.

[in] BufferSize

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

[out, optional] NameSize

Taille du nom 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, le nom du symbole ne rentrait pas dans la mémoire tampon mentionnée par le paramètre Buffer . Un nom tronqué a donc é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.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	dbgeng.h (inclure Dbgeng.h)

Voir aussi

GetNumberSymbols

IDebugSymbolGroup2

Partager via