Fonction Thread32First (tlhelp32.h)

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

Voir aussi

CreateToolhelp32Snapshot

THREADENTRY32

Thread Walking

Thread32Next

Fonctions d’aide de l’outil