Module32FirstW, fonction (tlhelp32.h)

Récupère des informations sur le premier module associé à un processus.

Syntaxe

BOOL Module32FirstW(
  [in]      HANDLE           hSnapshot,
  [in, out] LPMODULEENTRY32W lpme
);

Paramètres

[in] hSnapshot

Handle vers l’instantané retourné par un appel précédent à la fonction CreateToolhelp32Snapshot.

[in, out] lpme

Pointeur vers une structure MODULEENTRY32W.

Valeur de retour

Retourne TRUE si la première entrée de la liste de modules a été copiée dans la mémoire tampon ou FALSE sinon. La valeur d’erreur ERROR_NO_MORE_FILES est retournée par la fonction GetLastError si aucun module n’existe ou si l’instantané ne contient pas d’informations de module.

Remarques

L’application appelante doit définir le dwSize membre de MODULEENTRY32W sur la taille, en octets, de la structure.

Pour récupérer des informations sur d’autres modules associés au processus spécifié, utilisez la fonction Module32NextW.

Exemples

Pour obtenir un exemple, consultez Parcourir la liste de modules.

Note

L’en-tête tlhelp32.h définit Module32First comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	tlhelp32.h
bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

CreateToolhelp32Snapshot

MODULEENTRY32W

module marchant

Module32NextW

Tool Help Functions