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
IoAPI. h (include Windows. h);
WinBase. h sur Windows server 2008 R2, Windows 7, Windows server 2008 et Windows Vista (include Windows. h)
Bibliothèque
Kernel32.lib
DLL
Kernel32.dll

Voir aussi

CancelIo

CancelIoEx

Fonctions de gestion de fichiers

E/s synchrones et asynchrones