Fungsi CancelIo
Membatalkan semua operasi input dan output (I/O) yang tertunda yang dikeluarkan oleh utas panggilan untuk file yang ditentukan. Fungsi ini tidak membatalkan operasi I/O yang masalah utas lain untuk handel file.
Untuk membatalkan operasi I/O dari utas lain, gunakan fungsi CancelIoEx .
Sintaks
BOOL WINAPI CancelIo(
_In_ HANDLE hFile
);
Parameter
-
hFile [in]
-
Handel ke file.
Fungsi membatalkan semua operasi I/O yang tertunda untuk handel file ini.
Menampilkan nilai
Jika fungsi berhasil, nilai yang dikembalikan bukan nol. Operasi pembatalan untuk semua operasi I/O yang tertunda yang dikeluarkan oleh utas panggilan untuk handel file yang ditentukan berhasil diminta. Utas dapat menggunakan fungsi GetOverlappedResult untuk menentukan kapan operasi I/O itu sendiri telah selesai.
Jika fungsi gagal, nilai yang dikembalikan adalah nol (0). Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi GetLastError .
Keterangan
Jika ada operasi I/O yang tertunda yang sedang berlangsung untuk handel file yang ditentukan, dan operasi tersebut dikeluarkan oleh utas panggilan, fungsi CancelIo membatalkannya. CancelIo hanya membatalkan I/O yang beredar pada handel, itu tidak mengubah status handel; ini berarti Anda tidak dapat mengandalkan status handel karena Anda tidak dapat mengetahui apakah operasi berhasil diselesaikan atau dibatalkan.
Operasi I/O harus dikeluarkan sebagai I/O yang tumpang tindih. Jika tidak, operasi I/O tidak kembali untuk mengizinkan utas memanggil fungsi CancelIo . Memanggil fungsi CancelIo dengan handel file yang tidak dibuka dengan FILE_FLAG_OVERLAPPED tidak melakukan apa pun.
Semua operasi I/O yang dibatalkan selesai dengan kesalahan ERROR_OPERATION_ABORTED, dan semua pemberitahuan penyelesaian untuk operasi I/O terjadi secara normal.
Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.
| Teknologi | Didukung |
|---|---|
| Protokol Server Message Block (SMB) 3.0 |
Ya |
| SMB 3.0 Transparent Failover (TFO) |
Ya |
| SMB 3.0 dengan Berbagi File Peluasan Skala (SO) |
Ya |
| Sistem File Volume Bersama Kluster (CsvFS) |
Ya |
| Sistem File Tangguh (ReFS) |
Ya |
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows XP [aplikasi desktop | Aplikasi UWP] |
| Server minimum yang didukung |
Windows Server 2003 [aplikasi desktop | Aplikasi UWP] |
| Header |
|
| Pustaka |
|
| DLL |
|