Fungsi CancelIo (ioapiset.h)
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 CancelIo(
[in] HANDLE hFile
);
Parameter
[in] hFile
Handel ke file.
Fungsi membatalkan semua operasi I/O yang tertunda untuk handel file ini.
Mengembalikan 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] |
| Target Platform | Windows |
| Header | ioapiset.h (termasuk Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |