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 |