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

Article
02/06/2025

La méthode GetModuleByOffset2 recherche dans les modules du processus pour un module dont l’allocation de mémoire inclut l’emplacement spécifié.

Syntaxe

HRESULT GetModuleByOffset2(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [in]            ULONG    Flags,
  [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.

[in] Flags

Spécifie un jeu de bits contenant des options utilisées lors de la recherche du module avec l’emplacement spécifié. indicateurs peuvent contenir les indicateurs de bits suivants :

Drapeau	Effet
DEBUG_GETMOD_NO_LOADED_MODULES	Ne recherchez pas les modules chargés.
DEBUG_GETMOD_NO_UNLOADED_MODULES	Ne recherchez pas les modules déchargés.

[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.