CancelSynchronousIo, fonction (ioapiset.h)

  • Article

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é.
Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
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

Voir aussi

CancelIo

CancelIoEx

Fonctions de gestion des fichiers

E/S synchrones et asynchrones