Méthode IDebugSymbolGroup ::GetSymbolName (dbgeng.h)

Article
02/26/2024

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 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é.