Bagikan melalui

Fungsi CancelSynchronousIo

  • Artikel

Menandai operasi I/O sinkron yang tertunda yang dikeluarkan oleh utas yang ditentukan sebagai dibatalkan.

Sintaks

BOOL WINAPI CancelSynchronousIo(
  _In_ HANDLE hThread
);

Parameter

hThread[in]

Handel ke utas.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah 0 (nol). Untuk mendapatkan informasi kesalahan yang diperluas, panggil fungsi GetLastError .

Jika fungsi ini tidak dapat menemukan permintaan untuk dibatalkan, nilai yang dikembalikan adalah 0 (nol), dan GetLastError mengembalikan ERROR_NOT_FOUND.

Keterangan

Pemanggil harus memiliki hak akses THREAD_TERMINATE .

Jika ada operasi I/O yang tertunda yang sedang berlangsung untuk utas yang ditentukan, fungsi CancelSynchronousIo menandainya untuk pembatalan. Sebagian besar jenis operasi dapat segera dibatalkan; operasi lain dapat terus menuju penyelesaian sebelum benar-benar dibatalkan dan pemanggil diberi tahu. Fungsi CancelSynchronousIo tidak menunggu semua operasi yang dibatalkan selesai. Untuk informasi selengkapnya, lihat Panduan Penyelesaian/Pembatalan I/O.

Operasi yang dibatalkan diselesaikan dengan salah satu dari tiga status; Anda harus memeriksa status penyelesaian untuk menentukan status penyelesaian. Tiga status tersebut adalah:

  • Operasi selesai secara normal. Ini dapat terjadi bahkan jika operasi dibatalkan, karena permintaan pembatalan mungkin belum dikirimkan pada waktunya untuk membatalkan operasi.
  • Operasi dibatalkan. Fungsi GetLastError mengembalikan ERROR_OPERATION_ABORTED.
  • Operasi gagal dengan kesalahan lain. Fungsi GetLastError mengembalikan kode kesalahan yang relevan.

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 Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Header IoAPI.h (termasuk Windows.h);
WinBase.h pada Windows Server 2008 R2, Windows 7, Windows Server 2008 dan Windows Vista (termasuk Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

CancelIo

CancelIoEx

Fungsi Manajemen File

I/O Sinkron dan Asinkron