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.
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 |