Partager via


CancelThreadpoolIo, fonction (threadpoolapiset.h)

Annule la notification de la fonction StartThreadpoolIo .

Syntaxe

void CancelThreadpoolIo(
  [in, out] PTP_IO pio
);

Paramètres

[in, out] pio

Pointeur vers une structure TP_IO qui définit l’objet d’achèvement d’E/S. La fonction CreateThreadpoolIo retourne ce pointeur.

Valeur de retour

None

Remarques

Pour éviter les fuites de mémoire, vous devez appeler la fonction CancelThreadpoolIo pour l’un des scénarios suivants :

  • Une opération d’E/S superposée (asynchrone) échoue (autrement dit, l’appel de fonction d’E/S asynchrone retourne un échec avec un code d’erreur autre que ERROR_IO_PENDING).
  • Une opération d’E/S asynchrone retourne immédiatement avec succès et le handle de fichier associé à l’objet d’achèvement d’E/S a le mode de notification FILE_SKIP_COMPLETION_PORT_ON_SUCCESS. Le handle de fichier ne notifie pas le port d’achèvement des E/S et la fonction de rappel d’E/S associée ne sera pas appelée.
Pour compiler une application qui utilise cette fonction, définissez _WIN32_WINNT comme 0x0600 ou une version ultérieure.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête threadpoolapiset.h (inclure Windows.h sur Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

CloseThreadpoolIo

CreateThreadpoolIo

StartThreadpoolIo

Pools de threads

WaitForThreadpoolIoCallbacks