Fungsi WSACancelAsyncRequest (winsock.h)
Fungsi WSACancelAsyncRequest membatalkan operasi asinkron yang tidak lengkap.
Sintaks
int WSACancelAsyncRequest(
[in] HANDLE hAsyncTaskHandle
);
Parameter
[in] hAsyncTaskHandle
Menangani yang menentukan operasi asinkron yang akan dibatalkan.
Mengembalikan nilai
Nilai yang dikembalikan oleh WSACancelAsyncRequest adalah nol jika operasi berhasil dibatalkan. Jika tidak, nilai SOCKET_ERROR dikembalikan, dan nomor kesalahan tertentu dapat diambil dengan memanggil WSAGetLastError.
Kode kesalahan | Makna |
---|---|
Panggilan WSAStartup yang berhasil harus terjadi sebelum menggunakan fungsi ini. | |
Subsistem jaringan gagal. | |
Menunjukkan bahwa handel tugas asinkron yang ditentukan tidak valid. | |
Pemblokiran panggilan Windows Sockets 1.1 sedang berlangsung, atau penyedia layanan masih memproses fungsi panggilan balik. | |
Rutinitas asinkron yang dibatalkan telah selesai. |
Keterangan
Fungsi WSACancelAsyncRequest digunakan untuk membatalkan operasi asinkron yang dimulai oleh salah satu fungsi WSAAsyncGetXByY seperti WSAAsyncGetHostByName. Operasi yang akan dibatalkan diidentifikasi oleh parameter hAsyncTaskHandle , yang harus diatur ke handel tugas asinkron seperti yang dikembalikan oleh fungsi WSAAsyncGetXByY yang dimulai.
Upaya untuk membatalkan operasi WSAAsyncGetXByY asinkron yang ada dapat gagal dengan kode kesalahan WSAEALREADY karena dua alasan. Pertama, operasi asli telah selesai dan aplikasi telah menangani pesan yang dihasilkan. Kedua, operasi asli telah selesai tetapi pesan yang dihasilkan masih menunggu dalam antrean jendela aplikasi.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | winsock.h (termasuk Winsock2.h) |
Pustaka | Ws2_32.lib |
DLL | Ws2_32.dll |