IDebugSymbols3 ::GetSymbolEntriesByOffset, méthode (dbgeng.h)

Article
02/06/2025

La méthode GetSymbolEntriesByOffset retourne les symboles situés à une adresse spécifiée.

Syntaxe

HRESULT GetSymbolEntriesByOffset(
  [in]            ULONG64              Offset,
  [in]            ULONG                Flags,
  [out, optional] PDEBUG_MODULE_AND_ID Ids,
  [out, optional] PULONG64             Displacements,
  [in]            ULONG                IdsCount,
  [out, optional] PULONG               Entries
);

Paramètres

[in] Offset

Spécifie un emplacement dans l’espace d’adressage de mémoire du processus dans la plage du symbole souhaité. Tous les symboles n’ont pas de plage connue. Par conséquent, pour de meilleurs résultats, utilisez l’adresse de base du symbole.

[in] Flags

Défini sur zéro.

[out, optional] Ids

Reçoit les symboles. Il s’agit d’un tableau d’entrées idsCount de type DEBUG_MODULE_AND_ID. Si ID est NULL, ces informations ne sont pas retournées.

[out, optional] Displacements

Reçoit les différences entre les adresses de base des symboles trouvés et l’adresse donnée en fonction de la plage du symbole.

[in] IdsCount

Spécifie le nombre d’entrées que les tableaux Ids et Les déplacements peuvent contenir.

[out, optional] Entries

Reçoit le nombre de symboles situés à offset. Si entrées est NULL, ces informations ne sont pas retournées.

Valeur de retour

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

Retourner le code	Description
S_OK	La méthode a réussi.

Remarques

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

Exigences

Exigence	Valeur
plateforme cible	Bureau
d’en-tête	dbgeng.h (include Dbgeng.h)

Voir aussi

GetSymbolEntriesByName

IDebugSymbols3

Partager via