Fungsi panggilan balik LPWSPSHUTDOWN (ws2spi.h)
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 |
---|---|
Subsistem jaringan gagal. | |
Caranya tidak valid, atau tidak konsisten dengan jenis soket. Misalnya, SD_SEND digunakan dengan jenis soket UNI_RECV. | |
Fungsi dipanggil saat panggilan balik sedang berlangsung. | |
Soket tidak terhubung (hanya soket berorientasi koneksi). | |
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 |