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.

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
ntioapi.h
Pustaka
ntdll.lib

Lihat juga

CancelIoEx