Fungsi WSACancelAsyncRequest (winsock.h)

Artikel
03/15/2023

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
WSANOTINITIALISED	Panggilan WSAStartup yang berhasil harus terjadi sebelum menggunakan fungsi ini.
WSAENETDOWN	Subsistem jaringan gagal.
WSAEINVAL	Menunjukkan bahwa handel tugas asinkron yang ditentukan tidak valid.
WSAEINPROGRESS	Pemblokiran panggilan Windows Sockets 1.1 sedang berlangsung, atau penyedia layanan masih memproses fungsi panggilan balik.
WSAEALREADY	Rutinitas asinkron yang dibatalkan telah selesai.

Catatan Tidak jelas apakah aplikasi dapat secara berguna membedakan antara WSAEINVAL dan WSAEALREADY, karena dalam kedua kasus kesalahan menunjukkan bahwa tidak ada operasi asinkron yang sedang berlangsung dengan handel yang ditunjukkan. (Pengecualian sepele: nol selalu merupakan handel tugas asinkron yang tidak valid.) Spesifikasi Windows Sockets tidak menentukan bagaimana penyedia Windows Sockets yang sesuai harus membedakan antara kedua kasus. Untuk portabilitas maksimum, aplikasi Windows Sockets harus memperlakukan dua kesalahan yang setara.

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