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