Bagikan melalui


Fungsi CancelThreadpoolIo (threadpoolapiset.h)

Membatalkan pemberitahuan dari fungsi StartThreadpoolIo .

Sintaks

void CancelThreadpoolIo(
  [in, out] PTP_IO pio
);

Parameter

[in, out] pio

Penunjuk ke struktur TP_IO yang menentukan objek penyelesaian I/O. Fungsi CreateThreadpoolIo mengembalikan penunjuk ini.

Mengembalikan nilai

Tidak ada

Keterangan

Untuk mencegah kebocoran memori, Anda harus memanggil fungsi CancelThreadpoolIo untuk salah satu skenario berikut:

  • Operasi I/O yang tumpang tindih (asinkron) gagal (yaitu, panggilan fungsi I/O asinkron mengembalikan kegagalan dengan kode kesalahan selain ERROR_IO_PENDING).
  • Operasi I/O asinkron segera kembali dengan sukses dan handel file yang terkait dengan objek penyelesaian I/O memiliki mode pemberitahuan FILE_SKIP_COMPLETION_PORT_ON_SUCCESS. Handel file tidak akan memberi tahu port penyelesaian I/O dan fungsi panggilan balik I/O terkait tidak akan dipanggil.
Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau lebih tinggi.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header threadpoolapiset.h (termasuk Windows.h pada Windows 7, Windows Server 2008 Windows Server 2008 R2)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

CloseThreadpoolIo

CreateThreadpoolIo

StartThreadpoolIo

Kumpulan Utas

WaitForThreadpoolIoCallbacks