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

  • Article

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

Syntaxe

HRESULT GetSymbolEntryString(
  [in]            PDEBUG_MODULE_AND_ID Id,
  [in]            ULONG                Which,
  [out, optional] PSTR                 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 La mémoire tampon 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