struktur CSADDR_INFO (nspapi.h)
Struktur CSADDR_INFO berisi informasi alamat Soket Windows untuk soket, layanan jaringan, atau penyedia namespace.
Sintaks
typedef struct _CSADDR_INFO {
SOCKET_ADDRESS LocalAddr;
SOCKET_ADDRESS RemoteAddr;
INT iSocketType;
INT iProtocol;
} CSADDR_INFO, *PCSADDR_INFO, *LPCSADDR_INFO;
Anggota
LocalAddr
Jenis: SOCKET_ADDRESS
Alamat lokal Windows Sockets.
Dalam aplikasi klien, teruskan alamat ini ke fungsi ikatan untuk mendapatkan akses ke layanan jaringan.
Dalam layanan jaringan, teruskan alamat ini ke fungsi ikatan sehingga layanan terikat ke alamat lokal yang sesuai.
RemoteAddr
Jenis: SOCKET_ADDRESS
Alamat jarak jauh Windows Sockets.
Ada beberapa kegunaan untuk alamat jarak jauh ini:
- Anda dapat menggunakan alamat jarak jauh ini untuk menyambungkan ke layanan melalui fungsi sambungkan . Ini berguna jika aplikasi melakukan operasi kirim/terima yang melibatkan protokol berorientasi koneksi.
- Anda dapat menggunakan alamat jarak jauh ini dengan fungsi sendto saat Anda berkomunikasi melalui protokol tanpa koneksi (datagram). Jika Anda menggunakan protokol tanpa koneksi, seperti UDP, sendto biasanya merupakan cara Anda meneruskan data ke sistem jarak jauh.
iSocketType
Jenis: INT
Jenis soket Windows. Nilai yang mungkin untuk jenis soket ditentukan dalam file header Winsock2.h .
Tabel berikut ini mencantumkan kemungkinan nilai yang didukung untuk Windows Sockets 2:
| Nilai | Makna |
|---|---|
|
Soket aliran. Ini adalah protokol yang mengirim data sebagai aliran byte, tanpa batas pesan. Jenis soket ini menyediakan aliran byte berbasis koneksi berurutan, andal, dua arah, dengan mekanisme transmisi data OOB. Jenis soket ini menggunakan Protokol Kontrol Transmisi (TCP) untuk keluarga alamat Internet (AF_INET atau AF_INET6). |
|
Soket datagram. Jenis soket ini mendukung datagram, yang merupakan buffer tanpa koneksi dan tidak dapat diandalkan dengan panjang maksimum tetap (biasanya kecil). Jenis soket ini menggunakan Protokol Datagram Pengguna (UDP) untuk keluarga alamat Internet (AF_INET atau AF_INET6).
Layanan menggunakan fungsi recvfrom untuk mendapatkan datagram. Fungsi dengarkan dan terima tidak berfungsi dengan datagram. |
|
Soket datagram pesan yang andal. Jenis soket ini mempertahankan batas pesan dalam data. Contoh dari jenis ini adalah implementasi protokol multicast Pragmatic General Multicast (PGM) di Windows, sering disebut sebagai pemrograman multicast yang andal. |
|
Soket aliran paket berurutan. Jenis soket ini menyediakan paket pseudo-stream berdasarkan datagram. |
iProtocol
Jenis: INT
Protokol yang digunakan. Opsi yang mungkin untuk parameter protokol khusus untuk keluarga alamat dan jenis soket yang ditentukan. Nilai yang mungkin ditentukan dalam file header Winsock2.h dan Wsrm.h .
Pada Windows SDK yang dirilis untuk Windows Vista dan yang lebih baru, organisasi file header telah berubah dan parameter ini dapat menjadi salah satu nilai dari jenis enumerasi IPPROTO yang ditentukan dalam file header Ws2def.h . Perhatikan bahwa file header Ws2def.h secara otomatis disertakan dalam Winsock2.h, dan tidak boleh digunakan secara langsung.
Tabel di bawah ini mencantumkan nilai umum untuk protokol meskipun banyak nilai lain dimungkinkan.
Keterangan
Fungsi GetAddressByName mendapatkan informasi alamat Windows Sockets menggunakan struktur CSADDR_INFO .
Fungsi getsockopt yang dipanggil dengan opsi soket SO_BSP_STATE mengambil struktur CSADDR_INFO untuk soket yang ditentukan.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Header | nspapi.h (termasuk Nspapi.h) |