CancelSynchronousIo, fonction (ioapiset.h)
Marque comme étant annulées les opérations d’E/S synchrones en attente qui sont émises par le thread spécifié.
Syntaxe
BOOL CancelSynchronousIo(
[in] HANDLE hThread
);
Paramètres
[in] hThread
Handle pour le thread.
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 zéro (0). Pour obtenir des informations détaillées sur l’erreur, appelez la fonction GetLastError.
Si cette fonction ne trouve pas de demande à annuler, la valeur de retour est 0 (zéro) et GetLastError retourne ERROR_NOT_FOUND.
Notes
L’appelant doit disposer du droit d’accès THREAD_TERMINATE.
S’il y a des opérations d’E/S en attente en cours pour le thread spécifié, la fonction CancelSynchronousIo les marque pour annulation. La plupart des types d’opérations peuvent être annulées immédiatement ; d’autres opérations peuvent se poursuivre jusqu’à leur achèvement avant qu’elles soient réellement annulées et que l’appelant soit averti. La fonction CancelSynchronousIo n’attend pas que toutes les opérations annulées se terminent. Pour plus d’informations, consultez Annulation des opérations d’E/S en attente.
L’opération en cours d’annulation est achevée avec un des trois statuts suivants : vous devez vérifier le statut d’achèvement pour déterminer l’état d’achèvement. Les trois statuts sont :
- L’opération s’est terminée normalement. Ceci peut se produire même si l’opération a été annulée, car la demande d’annulation peut ne pas avoir été envoyée à temps pour annuler l’opération.
- L'opération a été annulée. La fonction GetLastError retourne ERROR_OPERATION_ABORTED.
- L’opération a échoué avec une autre erreur. La fonction GetLastError retourne le code d’erreur approprié.
| Technologie | Prise en charge |
|---|---|
| Protocole Server Message Block (SMB) 3.0 | Oui |
| Basculement transparent SMB 3.0 (TFO) | Oui |
| SMB 3.0 avec partages de fichiers avec scale-out (SO) | Oui |
| Système de fichiers du volume partagé de cluster (CsvFS) | Oui |
| Système de fichiers résilient (ReFS) | Oui |
Configuration requise
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | ioapiset.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |