Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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.
Sintaks
BOOL WINAPI NtCancelIoFile(
_In_ HANDLE hFile
);
Parameter
hFile [in]
Handel ke file.
Fungsi membatalkan semua operasi I/O yang tertunda untuk handel file ini.
Mengembalikan
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 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
| Persyaratan | Nilai |
|---|---|
| Header |
|
| Pustaka |
|