Funzione CancelSynchronousIo
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 |