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

Article
02/06/2025

La méthode GetOffsetByName retourne l’emplacement d’un symbole identifié par son nom.

Syntaxe

HRESULT GetOffsetByName(
  [in]  PCSTR    Symbol,
  [out] PULONG64 Offset
);

Paramètres

[in] Symbol

Spécifie le nom du symbole à localiser. Le nom peut être qualifié par un nom de module (par exemple, mymodule !main).

[out] Offset

Reçoit l’emplacement dans l’espace d’adressage mémoire de la cible de la base de l’allocation de mémoire du symbole.

Valeur de retour

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

Retourner le code	Description
S_OK	La méthode a réussi.
S_FALSE	La méthode a réussi. Toutefois, le nom Symbole n’était pas unique et plusieurs symboles portant ce nom ont été trouvés. L’un de ces symboles a été choisi arbitrairement et retourné.
E_FAIL	Aucun symbole n’est trouvé avec le nom spécifié.

Remarques

Si le nom Symbole n’est pas unique et GetOffsetByName trouve plusieurs symboles portant ce nom, l’ambiguïté sera résolue arbitrairement. Dans ce cas, la valeur S_FALSE est retournée. StartSymbolMatch pouvez être utilisé pour lancer une recherche pour déterminer quel est le résultat souhaité.

GetNameByOffset ne prend pas en charge la correspondance des modèles (par exemple, les caractères génériques). Pour rechercher un symbole à l’aide d’un modèle correspondant, utilisez StartSymbolMatch.

Si le nom du module pour le symbole est connu, il est préférable de qualifier le nom du symbole avec le nom du module. Sinon, le moteur recherche les symboles de tous les modules jusqu’à ce qu’il trouve une correspondance ; cela peut prendre beaucoup de temps s’il doit charger les fichiers de symboles pour un grand nombre de modules. Si le nom du symbole est qualifié avec un nom de module, le moteur recherche uniquement les symboles de ce module.

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