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

Article
02/06/2025

La méthode GetModuleByOffset effectue une recherche dans les modules de la cible pour une unité dont l’allocation de mémoire inclut l’emplacement spécifié.

Syntaxe

HRESULT GetModuleByOffset(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Paramètres

[in] Offset

Spécifie un emplacement dans l’espace d’adressage virtuel de la cible qui se trouve à l’intérieur de l’allocation de mémoire du module souhaité, par exemple l’adresse d’un symbole appartenant au module.

[in] StartIndex

Spécifie l’index à partir duquel commencer la recherche.

[out, optional] Index

Reçoit l’index du module. Si d’index est NULL, ces informations ne sont pas retournées.

[out, optional] Base

Reçoit l’emplacement dans l’espace d’adressage mémoire de la cible de la base du module. Si base 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

À partir de l’index spécifié, cette méthode retourne le premier module dont la plage d’adresses d’allocation de mémoire inclut l’emplacement spécifié. Si la cible a plusieurs modules dont la plage d’adresses mémoire inclut cet emplacement, les modules suivants sont trouvés par des appels répétés à cette méthode avec des valeurs supérieures de StartIndex.

Pour plus d’informations sur les modules, consultez Modules.