Fonction Thread32First (tlhelp32.h)

Article
03/04/2024

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

Syntaxe

BOOL Thread32First(
  [in]      HANDLE          hSnapshot,
  [in, out] LPTHREADENTRY32 lpte
);

Paramètres

[in] hSnapshot

Un handle du instantané retourné par un appel précédent à la fonction CreateToolhelp32Snapshot.

[in, out] lpte

Pointeur vers une structure THREADENTRY32 .

Valeur retournée

Retourne TRUE si la première entrée de la liste de threads 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 thread n’existe ou si le instantané ne contient pas d’informations de thread.

Remarques

L’application appelante doit définir le membre dwSize de THREADENTRY32 sur la taille, en octets, de la structure. Thread32First modifie dwSize en nombre d’octets écrits dans la structure. Cela ne sera jamais supérieur à la valeur initiale de dwSize, mais il peut être plus petit. Si la valeur est plus petite, ne vous appuyez pas sur les valeurs des membres dont les décalages sont supérieurs à cette valeur.

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

Exemples

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

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