Process32First, fonction (tlhelp32.h)

Article
03/02/2024

Récupère des informations sur le premier processus rencontré dans un instantané système.

Syntaxe

BOOL Process32First(
  [in]      HANDLE           hSnapshot,
  [in, out] LPPROCESSENTRY32 lppe
);

Paramètres

[in] hSnapshot

Un handle au instantané retourné à partir d’un appel précédent à la fonction CreateToolhelp32Snapshot.

[in, out] lppe

Pointeur vers une structure PROCESSENTRY32 . Il contient des informations de processus telles que le nom du fichier exécutable, l’identificateur de processus et l’identificateur de processus du processus parent.

Valeur retournée

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

Remarques

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

Pour récupérer des informations sur d’autres processus enregistrés dans le même instantané, utilisez la fonction Process32Next.

Exemples

Pour obtenir un exemple, consultez Prise d’un instantané et Affichage des processus.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	tlhelp32.h
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll