Share via

GetModuleInformation, fonction (psapi.h)

  • Article

Récupère des informations sur le module spécifié dans la structure MODULEINFO .

Syntaxe

BOOL GetModuleInformation(
  [in]  HANDLE       hProcess,
  [in]  HMODULE      hModule,
  [out] LPMODULEINFO lpmodinfo,
  [in]  DWORD        cb
);

Paramètres

[in] hProcess

Handle du processus qui contient le module.

Le handle doit avoir les droits d’accès PROCESS_QUERY_INFORMATION et PROCESS_VM_READ . Pour plus d’informations, consultez Droits d’accès et de sécurité des processus.

[in] hModule

Handle pour le module.

[out] lpmodinfo

Pointeur vers la structure MODULEINFO qui reçoit des informations sur le module.

[in] cb

Taille de la structure MODULEINFO , en octets.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Pour obtenir des informations sur le processus appelant, transmettez le handle retourné par GetCurrentProcess.

La fonction GetModuleInformation ne récupère pas d’informations pour les modules qui ont été chargés avec l’indicateur LOAD_LIBRARY_AS_DATAFILE . Pour plus d’informations, consultez LoadLibraryEx.

À compter de Windows 7 et Windows Server 2008 R2, Psapi.h établit des numéros de version pour les fonctions PSAPI. Le numéro de version PSAPI affecte le nom utilisé pour appeler la fonction et la bibliothèque qu’un programme doit charger.

Si PSAPI_VERSION a la valeur 2 ou supérieure, cette fonction est définie comme K32GetModuleInformation dans Psapi.h et exportée dans Kernel32.lib et Kernel32.dll. Si PSAPI_VERSION a la valeur 1, cette fonction est définie comme K32GetModuleInformation dans Psapi.h et exportée dans Psapi.lib et Psapi.dll en tant que wrapper qui appelle K32GetModuleInformation.

Les programmes qui doivent s’exécuter sur des versions antérieures de Windows ainsi que Sur Windows 7 et versions ultérieures doivent toujours appeler cette fonction K32GetModuleInformation. Pour garantir une résolution correcte des symboles, ajoutez Psapi.lib à la macro TARGETLIBS et compilez le programme avec -DPSAPI_VERSION=1. Pour utiliser la liaison dynamique au moment de l’exécution, chargez Psapi.dll.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête psapi.h
Bibliothèque Kernel32.lib sur Windows 7 et Windows Server 2008 R2 ; Psapi.lib (si PSAPI_VERSION=1) sur Windows 7 et Windows Server 2008 R2 ; Psapi.lib sur Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP
DLL Kernel32.dll sur Windows 7 et Windows Server 2008 R2 ; Psapi.dll (si PSAPI_VERSION=1) sur Windows 7 et Windows Server 2008 R2 ; Psapi.dll sur Windows Server 2008, Windows Vista, Windows Server 2003 et Windows XP

Voir aussi

EnumProcesses

MODULEINFO

Informations sur le module

Fonctions PSAPI