Fungsi panggilan balik LPWSPSENDDISCONNECT (ws2spi.h)

Artikel
03/13/2024

Fungsi LPWSPSendDisconnect memulai penghentian koneksi untuk soket dan mengirim data pemutusan sambungan.

Sintaks

LPWSPSENDDISCONNECT Lpwspsenddisconnect;

int Lpwspsenddisconnect(
  [in]  SOCKET s,
  [in]  LPWSABUF lpOutboundDisconnectData,
  [out] LPINT lpErrno
)
{...}

Parameter

[in] s

Deskriptor mengidentifikasi soket.

[in] lpOutboundDisconnectData

Arahkan ke data pemutusan sambungan keluar.

[out] lpErrno

Arahkan ke kode kesalahan.

Mengembalikan nilai

Jika tidak ada kesalahan yang terjadi, LPWSPSendDisconnect mengembalikan nol. Jika tidak, nilai SOCKET_ERROR dikembalikan, dan kode kesalahan tertentu tersedia di lpErrno.

Kode Kesalahan	Makna
WSAENETDOWN	Subsistem jaringan gagal.
WSAENOPROTOOPT	Parameter lpOutboundDisconnectData tidak null, dan data pemutusan sambungan tidak didukung oleh penyedia layanan.
WSAEINPROGRESS	Pemblokiran panggilan Windows Sockets sedang berlangsung, atau penyedia layanan masih memproses fungsi panggilan balik.
WSAENOTCONN	Soket tidak terhubung (hanya soket berorientasi koneksi).
WSAENOTSOCK	Deskriptor bukan soket.
WSAEFAULT	Parameter lpOutboundDisconnectData tidak sepenuhnya terkandung dalam bagian ruang alamat pengguna yang valid.

Keterangan

Fungsi LPWSPSendDisconnect digunakan pada soket berorientasi koneksi untuk menonaktifkan transmisi, dan untuk memulai penghentian koneksi bersama dengan transmisi data pemutusan sambungan, jika ada.

Setelah fungsi ini berhasil diterbitkan, pengiriman berikutnya tidak diizinkan.

Parameter lpOutboundDisconnectData , jika tidak null, menunjuk ke buffer yang berisi data pemutusan keluar yang akan dikirim ke pihak jarak jauh.

Perhatikan bahwa LPWSPSendDisconnect tidak menutup soket, dan sumber daya yang terpasang pada soket tidak akan dibebaskan sampai LPWSPCloseSocket dipanggil.

Catatan

Fungsi LPWSPSendDisconnect tidak memblokir terlepas dari pengaturan SO_LINGER pada soket. Klien Windows Sockets SPI tidak boleh mengandalkan untuk dapat menggunakan kembali soket setelah terputus. Secara khusus, penyedia Soket Windows tidak diperlukan untuk mendukung penggunaan LPWSPConnect pada soket tersebut.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	ws2spi.h

Lihat juga

LPWSPConnect

LPWSPSocket

Bagikan melalui