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:
- L'operazione è stata completata normalmente. Ciò può verificarsi anche se l'operazione è stata annullata, perché la richiesta di annullamento potrebbe non essere stata inviata in 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 con scalabilità orizzontale (SO) |
Sì |
| File system del volume condiviso del cluster (CsvFS) |
Sì |
| File system resiliente (ReFS) |
Sì |
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows Vista [solo app desktop] |
| Server minimo supportato |
Windows Server 2008 [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|