struktur CSADDR_INFO (nspapi.h)

Artikel
08/25/2023

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
SOCK_STREAM	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).
SOCK_DGRAM	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.
SOCK_RDM	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.
SOCK_SEQPACKET	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.

protokol	Makna
IPPROTO_TCP 6	Protokol Kontrol Transmisi (TCP). Ini adalah nilai yang mungkin ketika keluarga alamat AF_INET atau AF_INET6 dan anggota iSocketTypeSOCK_STREAM.
IPPROTO_UDP 17	Protokol Datagram Pengguna (UDP). Ini adalah nilai yang mungkin ketika keluarga alamat AF_INET atau AF_INET6 dan anggota iSocketTypeSOCK_DGRAM.
IPPROTO_RM 113	Protokol PGM untuk multicast yang andal. Ini adalah nilai yang mungkin ketika keluarga alamat AF_INET dan anggota iSocketTypeSOCK_RDM. Pada Windows SDK yang dirilis untuk Windows Vista dan yang lebih baru, nilai ini juga disebut IPPROTO_PGM.

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)