Fonction CreateTimerQueue (threadpoollegacyapiset.h)
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 |