CancelSynchronousIo fonction)
Marque les opérations d’e/s synchrones en attente qui sont émises par le thread spécifié comme annulées.
Syntaxe
BOOL WINAPI CancelSynchronousIo(
_In_ HANDLE hThread
);
Paramètres
-
hThread [ dans]
-
Handle du 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 0 (zéro). Pour afficher les informations d’erreur étendues, appelez la fonction GetLastError .
Si cette fonction ne peut pas trouver de demande d’annulation, la valeur de retour est 0 (zéro), et GetLastError retourne l' erreur _ _ introuvable.
Remarques
L’appelant doit disposer du droit d’accès de _ terminaison du thread .
Si des opérations d’e/s en attente sont en cours pour le thread spécifié, la fonction CancelSynchronousIo les marque pour l’annulation. La plupart des types d’opérations peuvent être annulés immédiatement ; d’autres opérations peuvent continuer à se terminer avant qu’elles ne soient réellement annulées et que l’appelant soit notifié. La fonction CancelSynchronousIo n’attend pas que toutes les opérations annulées soient terminées. Pour plus d’informations, consultez instructions d’achèvement/annulation d’e/s.
L’opération qui est annulée se termine avec l’un des trois États suivants : vous devez vérifier l’état d’achèvement pour déterminer l’état d’achèvement. Les trois États sont les suivants :
- L’opération s’est terminée normalement. Cela peut se produire même si l’opération a été annulée, car la demande d’annulation n’a peut-être pas été envoyée dans le temps pour annuler l’opération.
- L'opération a été annulée. La fonction GetLastError retourne une erreur indiquant que l’opération a été _ _ abandonnée.
- L’opération a échoué avec une autre erreur. La fonction GetLastError retourne le code d’erreur approprié.
dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
| Technology | Pris en charge |
|---|---|
| Protocole SMB (Server Message Block) 3,0 |
Oui |
| Basculement transparent SMB 3,0 (TFO) |
Oui |
| SMB 3,0 avec des partages de fichiers avec montée en puissance parallèle (SO) |
Oui |
| Système de fichiers Volume partagé de cluster (CsvFS) |
Oui |
| Système de fichiers résilient (ReFS) |
Oui |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows [Applications de bureau Vista uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2008 [ applications de bureau uniquement] |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|