Fonction CancelIo
Annule toutes les opérations d’entrée et de sortie (E/S) en attente qui sont émises par le thread appelant pour le fichier spécifié. La fonction n’annule pas les opérations d’E/S que d’autres threads émettent pour un handle de fichier.
Pour annuler les opérations d’E/S à partir d’un autre thread, utilisez la fonction CancelIoEx .
Syntaxe
BOOL WINAPI CancelIo(
_In_ HANDLE hFile
);
Paramètres
-
hFile [in]
-
Handle du fichier.
La fonction annule toutes les opérations d’E/S en attente pour ce handle de fichier.
Valeur retournée
Si la fonction réussit, la valeur de retour est différente de zéro. L’opération d’annulation de toutes les opérations d’E/S en attente émises par le thread appelant pour le handle de fichier spécifié a été demandée avec succès. Le thread peut utiliser la fonction GetOverlappedResult pour déterminer quand les opérations d’E/S elles-mêmes ont été effectuées.
Si la fonction échoue, la valeur de retour est zéro (0). Pour obtenir des informations d’erreur étendues, appelez la fonction GetLastError .
Notes
Si des opérations d’E/S en attente sont en cours pour le handle de fichier spécifié et qu’elles sont émises par le thread appelant, la fonction CancelIo les annule. CancelIo annule uniquement les E/S en attente sur le handle, il ne modifie pas l’état du handle ; cela signifie que vous ne pouvez pas compter sur l’état du handle, car vous ne pouvez pas savoir si l’opération a été terminée avec succès ou annulée.
Les opérations d’E/S doivent être émises en tant qu’E/S qui se chevauchent. Si ce n’est pas le cas, les opérations d’E/S ne retournent pas pour permettre au thread d’appeler la fonction CancelIo . L’appel de la fonction CancelIo avec un handle de fichier qui n’est pas ouvert avec FILE_FLAG_OVERLAPPED ne fait rien.
Toutes les opérations d’E/S annulées se terminent avec l’erreur ERROR_OPERATION_ABORTED, et toutes les notifications d’achèvement pour les opérations d’E/S se produisent normalement.
Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
Technology | Prise en charge |
---|---|
Protocole SMB (Server Message Block) 3.0 |
Oui |
Basculement transparent (TFO) SMB 3.0 |
Oui |
SMB 3.0 avec partages de fichiers avec montée en puissance sortante (SO) |
Oui |
Cluster Shared Volume File System (CsvFS) |
Oui |
Système de fichiers résilient (ReFS) |
Oui |
Spécifications
Condition requise | Valeur |
---|---|
Client minimal pris en charge |
Windows XP [applications de bureau | Applications UWP] |
Serveur minimal pris en charge |
Windows Server 2003 [applications de bureau | Applications UWP] |
En-tête |
|
Bibliothèque |
|
DLL |
|
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour