Funzione CancelSynchronousIo

  • Articolo

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

Sintassi

BOOL WINAPI CancelSynchronousIo(
  _In_ HANDLE hThread
);

Parametri

hThread[in]

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 Linee guida per il completamento/annullamento di I/O.

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

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione IoAPI.h (include Windows.h);
WinBase.h in Windows Server 2008 R2, Windows 7, Windows Server 2008 e Windows Vista (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

CancelIo

CancelIoEx

Funzioni di gestione file

I/O sincrono e asincrono