Bagikan melalui


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
IoAPI.h (termasuk Windows.h);
WinBase.h pada Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP (termasuk Windows.h)
Pustaka
Kernel32.lib
DLL
Kernel32.dll

Lihat juga

CancelIoEx

CancelSynchronousIo

CreateFile

DeviceIoControl

Fungsi Manajemen File

LockFileEx

ReadDirectoryChangesW

ReadFile

ReadFileEx

I/O Sinkron dan Asinkron

WriteFile

WriteFileEx