Méthode IDebugSymbols3 ::GetSymbolEntryStringWide (dbgeng.h)

Article
02/26/2024

La méthode GetSymbolEntryStringWide retourne des informations de chaîne pour le symbole spécifié.

Syntaxe

HRESULT GetSymbolEntryStringWide(
  [in]            PDEBUG_MODULE_AND_ID Id,
  [in]            ULONG                Which,
  [out, optional] PWSTR                Buffer,
  [in]            ULONG                BufferSize,
  [out, optional] PULONG               StringSize
);

Paramètres

[in] Id

Spécifie les symboles dont les régions de mémoire sont demandées. La structure DEBUG_MODULE_AND_ID contient le module contenant le symbole et l’ID de symbole du symbole dans le module.

[in] Which

Spécifie l’index de la chaîne souhaitée. Il s’agit souvent de zéro, car la plupart des symboles ne contiennent qu’une seule chaîne (leur nom). Toutefois, certains symboles peuvent contenir plusieurs chaînes, par exemple des symboles d’annotation.

[out, optional] Buffer

Reçoit le nom du symbole. Si Buffer a la valeur NULL, ces informations ne sont pas retournées.

[in] BufferSize

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

[out, optional] StringSize

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

Valeur retournée

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

Code de retour	Description
S_OK	La méthode a réussi.

Remarques

Pour plus d’informations sur les symboles, consultez Symboles.

Configuration requise

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

Voir aussi

GetSymbolEntriesByName

GetSymbolEntriesByOffset

IDebugSymbols3

Partager via