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

Article
08/07/2023

La méthode GetModuleByOffset2 recherche dans les modules du processus un 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 les options utilisées lors de la recherche du module avec l’emplacement spécifié. Les indicateurs peuvent contenir les indicateurs de bits suivants :

Indicateur	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 Index a la valeur 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 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

À partir de l’index spécifié, cette méthode retourne le premier module qu’elle trouve 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 peuvent être 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.