CancelSynchronousIo, fonction

  • Article

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[in]

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 0 (zéro). Pour obtenir des informations d’erreur étendues, appelez la fonction GetLastError .

Si cette fonction ne trouve pas de demande d’annulation, 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 .

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 se poursuivre jusqu’à leur achèvement avant qu’elles ne soient réellement annulées et que l’appelant soit averti. La fonction CancelSynchronousIo n’attend pas la fin de toutes les opérations annulées. Pour plus d’informations, consultez Instructions relatives à l’achèvement/annulation des E/S.

L’opération en cours d’annulation est terminée avec l’un des trois états suivants : vous devez case activée l’status 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 à 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.

Technology Pris en charge
Protocole SMB (Server Message Block) 3.0 Oui
Basculement transparent SMB 3.0 (TFO) 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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête IoAPI.h (inclure Windows.h) ;
WinBase.h sur Windows Server 2008 R2, Windows 7, Windows Server 2008 et Windows Vista (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

CancelIo

CancelIoEx

Fonctions de gestion de fichiers

E/S synchrones et asynchrones