Fonction SymGetModuleBase (dbghelp.h)

Récupère l’adresse de base du module qui contient l’adresse spécifiée.

Syntaxe

DWORD IMAGEAPI SymGetModuleBase(
  [in] HANDLE hProcess,
  [in] DWORD  dwAddr
);

Paramètres

[in] hProcess

Handle du processus qui a été passé à l’origine à la fonction SymInitialize .

[in] dwAddr

Adresse virtuelle contenue dans l’un des modules chargés par la fonction SymLoadModule64 .

Valeur retournée

Si la fonction réussit, la valeur de retour est une adresse virtuelle différente de zéro. La valeur est l’adresse de base du module contenant l’adresse spécifiée par le paramètre dwAddr .

Si la fonction échoue, la valeur de retour est égale à zéro. Pour récupérer des informations d’erreur étendues, appelez GetLastError.

Notes

La table de module est recherchée pour un module qui contient dwAddr. Le module se trouve en fonction de l’adresse de charge et de la taille de chaque module.

Toutes les fonctions DbgHelp, telles que celle-ci, sont à thread unique. Par conséquent, les appels de plusieurs threads à cette fonction entraîneront probablement un comportement inattendu ou une altération de la mémoire. Pour éviter cela, vous devez synchroniser tous les appels simultanés de plusieurs threads vers cette fonction.

Cette fonction remplace la fonction SymGetModuleBase . Pour plus d’informations, consultez Mise à jour de la prise en charge de la plateforme. SymGetModuleBase est défini comme suit dans DbgHelp.h.

#if !defined(_IMAGEHLP_SOURCE_) && defined(_IMAGEHLP64)
#define SymGetModuleBase SymGetModuleBase64
#else
DWORD
IMAGEAPI
SymGetModuleBase(
    __in HANDLE hProcess,
    __in DWORD dwAddr
    );
#endif

Spécifications

Plateforme cible	Windows
En-tête	dbghelp.h
Bibliothèque	Dbghelp.lib
DLL	Dbghelp.dll
Composant redistribuable	DbgHelp.dll 5.1 ou version ultérieure

Voir aussi

Fonctions DbgHelp

SymInitialize

SymLoadModule64