Fonction DeleteTimerQueueEx (threadpoollegacyapiset.h)

  • Article

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

Voir aussi

CreateTimerQueue

DeleteTimerQueueTimer

Fonctions de synchronisation

Regroupement des threads

Files d’attente du minuteur