Funzione CancelSynchronousIo (ioapiset.h)

  • Articolo

Contrassegna le operazioni di I/O sincrone in sospeso rilasciate dal thread specificato come annullate.

Sintassi

BOOL CancelSynchronousIo(
  [in] HANDLE hThread
);

Parametri

[in] hThread

Handle per il thread.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è 0 (zero). Per ottenere informazioni sull'errore estese, chiamare la funzione GetLastError .

Se questa funzione non riesce a trovare una richiesta di annullamento, il valore restituito è 0 (zero) e GetLastError restituisce ERROR_NOT_FOUND.

Commenti

Il chiamante deve avere il diritto di accesso THREAD_TERMINATE .

Se sono in corso operazioni di I/O in sospeso per il thread specificato, la funzione CancelSynchronousIo li contrassegna per l'annullamento. La maggior parte dei tipi di operazioni può essere annullata immediatamente; altre operazioni possono continuare verso il completamento prima che vengano effettivamente annullate e il chiamante riceve una notifica. La funzione CancelSynchronousIo non attende il completamento di tutte le operazioni annullate. Per altre informazioni, vedere Annullamento di operazioni di I/O in sospeso.

L'operazione annullata viene completata con uno dei tre stati; è necessario controllare lo stato di completamento per determinare lo stato di completamento. I tre stati sono:

  • Operazione completata normalmente. Ciò può verificarsi anche se l'operazione è stata annullata, perché la richiesta di annullamento potrebbe non essere stata inviata nel tempo per annullare l'operazione.
  • L'operazione è stata annullata. La funzione GetLastError restituisce ERROR_OPERATION_ABORTED.
  • L'operazione non è riuscita con un altro errore. La funzione GetLastError restituisce il codice di errore pertinente.
In Windows 8 e Windows Server 2012 questa funzione è supportata dalle tecnologie seguenti.
Tecnologia Supportato
Protocollo SMB (Server Message Block) 3.0 Sì
Failover trasparente SMB 3.0 (TFO) Sì
SMB 3.0 con condivisioni file di scalabilità orizzontale (SO) Sì
File system del volume condiviso cluster (CsvFS) Sì
Resilient File System (ReFS) Sì

Requisiti

   
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione ioapiset.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

CancelIo

CancelIoEx

Funzioni di gestione file

I/O sincrono e asincrono