Fonction DeleteTimerQueueEx (threadpoollegacyapiset.h)
Supprime une file d’attente du minuteur. Tous les minuteurs en attente dans la file d’attente sont annulés et supprimés.
Syntaxe
BOOL DeleteTimerQueueEx(
[in] HANDLE TimerQueue,
[in, optional] HANDLE CompletionEvent
);
Paramètres
[in] TimerQueue
Handle de la file d’attente du minuteur. Ce handle est retourné par la fonction CreateTimerQueue .
[in, optional] CompletionEvent
Handle à l’objet d’événement à signaler lorsque la fonction réussit et que toutes les fonctions de rappel sont terminées. Ce paramètre peut être NULL.
Si ce paramètre est INVALID_HANDLE_VALUE, la fonction attend que toutes les fonctions de rappel se terminent avant de retourner.
Si ce paramètre a la valeur NULL, la fonction marque le minuteur pour la suppression et retourne immédiatement. Toutefois, la plupart des appelants doivent attendre la fin de la fonction de rappel afin de pouvoir effectuer le nettoyage nécessaire.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
N’effectuez pas de blocage d’appels à DeleteTimerQueueEx à partir d’un rappel du minuteur.
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.
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 |