Fungsi NtCancelIoFile
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 NtCancelIoFileEx .
Catatan
Fungsi ini adalah mode pengguna yang setara dengan fungsi CancelIo Win32.
BOOL WINAPI NtCancelIoFile(
_In_ HANDLE hFile
);
Handel ke file.
Fungsi membatalkan semua operasi I/O yang tertunda untuk handel file ini.
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 .
Jika ada operasi I/O yang sedang berlangsung untuk handel file yang ditentukan, dan dikeluarkan oleh utas panggilan, fungsi NtCancelIoFile membatalkannya. NtCancelIoFile 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 memungkinkan utas memanggil fungsi NtCancelIoFile . Memanggil fungsi NtCancelIoFile dengan handel file yang tidak dibuka dengan FILE_FLAG_OVERLAPPED tidak melakukan apa-apa.
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 Scale-out File Shares (SO) |
Ya |
Sistem File Volume Bersama Kluster (CsvFS) |
Ya |
Sistem File Tangguh (ReFS) |
Ya |
Persyaratan | Nilai |
---|---|
Header |
|
Pustaka |
|