Fungsi WSASendDisconnect (winsock2.h)
Fungsi WSASendDisconnect memulai penghentian koneksi untuk soket dan mengirim data pemutusan sambungan.
Sintaks
int WSAAPI WSASendDisconnect(
[in] SOCKET s,
[in] LPWSABUF lpOutboundDisconnectData
);
Parameter
[in] s
Deskriptor mengidentifikasi soket.
[in] lpOutboundDisconnectData
Penunjuk ke data pemutusan sambungan keluar.
Mengembalikan nilai
Jika tidak ada kesalahan yang terjadi, WSASendDisconnect mengembalikan nol. Jika tidak, nilai SOCKET_ERROR dikembalikan, dan kode kesalahan tertentu dapat diambil dengan memanggil WSAGetLastError.
Kode kesalahan | Makna |
---|---|
Panggilan WSAStartup yang berhasil harus terjadi sebelum menggunakan fungsi ini. | |
Subsistem jaringan gagal. | |
Parameter lpOutboundDisconnectData bukan NULL, dan data pemutusan sambungan tidak didukung oleh penyedia layanan. | |
Pemblokiran panggilan Windows Sockets 1.1 sedang berlangsung, atau penyedia layanan masih memproses fungsi panggilan balik. | |
Soket tidak tersambung (hanya soket berorientasi koneksi). | |
Deskriptor bukan soket. | |
Parameter lpOutboundDisconnectData tidak sepenuhnya terkandung dalam bagian ruang alamat pengguna yang valid. |
Keterangan
Fungsi WSASendDisconnect digunakan pada soket berorientasi koneksi untuk menonaktifkan transmisi dan untuk memulai penghentian koneksi bersama dengan transmisi data pemutusan, jika ada. Ini setara dengan pematian (SD_SEND), kecuali bahwa WSASendDisconnect juga memungkinkan pengiriman data pemutusan sambungan (dalam protokol yang mendukungnya).
Setelah fungsi ini berhasil diterbitkan, pengiriman berikutnya tidak diizinkan.
Parameter lpOutboundDisconnectData , jika bukan NULL, menunjuk ke buffer yang berisi data pemutusan keluar yang akan dikirim ke pihak jarak jauh untuk diambil dengan menggunakan WSARecvDisconnect.
Fungsi WSASendDisconnect tidak memblokir terlepas dari pengaturan SO_LINGER pada soket.
Aplikasi tidak boleh mengandalkan untuk dapat menggunakan kembali soket setelah memanggil WSASendDisconnect. Secara khusus, penyedia Windows Sockets tidak diperlukan untuk mendukung penggunaan sambungkan/WSAConnect pada soket seperti itu.
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 | winsock2.h |
Pustaka | Ws2_32.lib |
DLL | Ws2_32.dll |