Fungsi GetAddrInfoExCancel (ws2tcpip.h)

Fungsi GetAddrInfoExCancel membatalkan operasi asinkron oleh fungsi GetAddrInfoEx .

Sintaks

INT WSAAPI GetAddrInfoExCancel(
  [in] LPHANDLE lpHandle
);

Parameter

[in] lpHandle

Handel operasi asinkron untuk dibatalkan. Ini adalah handel yang dikembalikan dalam parameter lpNameHandle oleh fungsi GetAddrInfoEx .

Nilai kembali

Setelah berhasil, GetAddrInfoExCancel mengembalikan NO_ERROR (0). Kegagalan mengembalikan kode kesalahan Windows Sockets bukan nol, seperti yang ditemukan di Kode Kesalahan Soket Windows.

Keterangan

Fungsi GetAddrInfoExCancel membatalkan operasi GetAddrInfoEx asinkron. Hasilnya adalah bahwa mekanisme penyelesaian pengguna, baik panggilan balik atau peristiwa, segera dipanggil. Tidak ada hasil yang dikembalikan, dan kode kesalahan yang dikembalikan untuk operasi asinkron GetAddrInfoEx diatur ke WSA_E_CANCELLED. Jika permintaan GetAddrInfoEx telah selesai atau kehabisan waktu, atau handel tidak valid, dan WSA_INVALID_HANDLE akan dikembalikan oleh fungsi GetAddrInfoExCancel .

Karena banyak operasi yang mendasar (penyedia layanan nama warisan, misalnya) sinkron, operasi ini sebenarnya tidak akan dibatalkan. Operasi ini akan terus berjalan dan menggunakan sumber daya. Setelah permintaan penyedia layanan nama terutang terakhir selesai, sumber daya akan dirilis.

Windows 8.1 dan Windows Server 2012 R2: Fungsi ini didukung untuk aplikasi Windows Store di Windows 8.1, Windows Server 2012 R2, dan yang lebih baru.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1, Windows 8 [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	ws2tcpip.h
Pustaka	Ws2_32.lib
DLL	Ws2_32.dll

Lihat juga

GetAddrInfoEx