Bagikan melalui

Fungsi panggilan balik LPWSPSHUTDOWN (ws2spi.h)

  • Artikel

Fungsi LPWSPShutdown menonaktifkan pengiriman dan/atau penerimaan pada soket.

Sintaks

LPWSPSHUTDOWN Lpwspshutdown;

int Lpwspshutdown(
  [in]  SOCKET s,
  [in]  int how,
  [out] LPINT lpErrno
)
{...}

Parameter

[in] s

Deskriptor mengidentifikasi soket.

[in] how

Bendera yang menjelaskan jenis operasi apa yang tidak akan lagi diizinkan.

[out] lpErrno

Arahkan ke kode kesalahan.

Mengembalikan nilai

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

Kode Kesalahan Makna
WSAENETDOWN
 Subsistem jaringan gagal.
WSAEINVAL
 Caranya tidak valid, atau tidak konsisten dengan jenis soket. Misalnya, SD_SEND digunakan dengan jenis soket UNI_RECV.
WSAEINPROGRESS
 Fungsi dipanggil saat panggilan balik sedang berlangsung.
WSAENOTCONN
 Soket tidak terhubung (hanya soket berorientasi koneksi).
WSAENOTSOCK
 Deskriptor bukan soket.

Keterangan

Fungsi LPWSPShutdown digunakan pada semua jenis soket untuk menonaktifkan penerimaan, transmisi, atau keduanya.

Jika bagaimana SD_RECEIVE, penerimaan berikutnya pada soket akan dilarang. Ini tidak berpengaruh pada lapisan protokol yang lebih rendah. Untuk soket TCP, jika masih ada data yang diantrekan pada soket yang menunggu untuk diterima, atau data tiba kemudian, koneksi diatur ulang, karena data tidak dapat dikirimkan kepada pengguna. Untuk soket UDP, datagram yang masuk diterima dan diantrekan. Dalam hal apapun paket kesalahan ICMP tidak akan dihasilkan.

Jika bagaimana SD_SEND, pengiriman berikutnya pada soket tidak diizinkan. Untuk soket TCP, FIN akan dikirim. Mengatur cara SD_BOTH menonaktifkan pengiriman dan penerimaan seperti yang dijelaskan di atas.

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

Catatan

Fungsi LPWSPShutdown tidak memblokir terlepas dari pengaturan SO_LINGER pada soket. Klien Windows Sockets SPI tidak boleh mengandalkan untuk dapat menggunakan kembali soket setelah dimatikan. Secara khusus, penyedia layanan Windows Sockets 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