Fonction ResumeThread (processthreadsapi.h)

  • Article

Décrémente le nombre de suspensions d’un thread. Lorsque le nombre de suspensions est décrémenté à zéro, l’exécution du thread reprend.

Syntaxe

DWORD ResumeThread(
  [in] HANDLE hThread
);

Paramètres

[in] hThread

Handle du thread à redémarrer.

Ce handle doit avoir le droit d’accès THREAD_SUSPEND_RESUME. Pour plus d’informations, consultez Sécurité des threads et droits d’accès.

Valeur retournée

Si la fonction réussit, la valeur de retour correspond au nombre de suspensions précédent du thread.

Si la fonction échoue, la valeur de retour est (DWORD) -1. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

La fonction ResumeThread vérifie le nombre de suspensions du thread sujet. Si le nombre de suspensions est égal à zéro, le thread n’est pas actuellement suspendu. Sinon, le nombre de suspensions du thread sujet est décrémenté. Si la valeur résultante est zéro, l’exécution du thread d’objet reprend.

Si la valeur de retour est zéro, le thread spécifié n’a pas été suspendu. Si la valeur de retour est 1, le thread spécifié a été suspendu, mais a été redémarré. Si la valeur de retour est supérieure à 1, le thread spécifié est toujours suspendu.

Notez que lorsque vous signalez des événements de débogage, tous les threads du processus de création de rapports sont figés. Les débogueurs doivent utiliser les fonctions SuspendThread et ResumeThread pour limiter l’ensemble de threads pouvant s’exécuter dans un processus. En suspendant tous les threads d’un processus à l’exception de celui qui signale un événement de débogage, il est possible d’effectuer une « étape unique » sur un seul thread. Les autres threads ne sont pas libérés par une opération de poursuite s’ils sont suspendus.

Windows Phone 8.1 : cette fonction est prise en charge pour les applications Windows Phone Store sur Windows Phone 8.1 et versions ultérieures.

Windows 8.1 et Windows Server 2012 R2 : cette fonction est prise en charge pour les applications du Windows Store sur Windows 8.1, Windows Server 2012 R2 et versions ultérieures.

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 processthreadsapi.h (inclure Windows.h sur Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque Kernel32.lib ; WindowsPhoneCore.lib sur Windows Phone 8.1
DLL Kernel32.dll ; KernelBase.dll sur Windows Phone 8.1

Voir aussi

OpenThread

Fonctions de processus et de thread

SuspendThread

Suspension de l’exécution de threads

Threads