Fonction CreateTimerQueue (threadpoollegacyapiset.h)

Article
08/26/2023

Crée une file d’attente pour les minuteurs. Les minuteurs de file d’attente sont des objets légers qui vous permettent de spécifier une fonction de rappel à appeler à une heure spécifiée.

Syntaxe

HANDLE CreateTimerQueue();

Valeur de retour

Si la fonction réussit, la valeur de retour est un handle de la file d’attente du minuteur. Ce handle ne peut être utilisé que dans les fonctions qui nécessitent un handle dans une file d’attente du minuteur.

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

Remarques

Pour ajouter un minuteur à la file d’attente, appelez la fonction CreateTimerQueueTimer . Pour supprimer un minuteur de la file d’attente, appelez la fonction DeleteTimerQueueTimer .

Lorsque vous avez terminé la file d’attente des minuteurs, appelez la fonction DeleteTimerQueueEx pour supprimer la file d’attente du minuteur. Tous les minuteurs en attente dans la file d’attente sont annulés et supprimés.

Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0500 ou version ultérieure. Pour plus d’informations, consultez Utilisation des en-têtes Windows.

Exemples

Pour obtenir un exemple qui utilise CreateTimerQueue, consultez Utilisation des files d’attente du minuteur.

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	threadpoollegacyapiset.h
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll