struktur IPV6_MREQ (ws2ipdef.h)

Artikel
08/28/2023

Struktur ipv6_mreq menyediakan informasi grup multicast untuk alamat IPv6.

Sintaks

typedef struct ipv6_mreq {
  IN6_ADDR ipv6mr_multiaddr;
  ULONG    ipv6mr_interface;
} IPV6_MREQ, *PIPV6_MREQ;

Anggota

ipv6mr_multiaddr

Alamat grup multicast IPv6.

ipv6mr_interface

Indeks antarmuka antarmuka lokal tempat grup multicast harus digabungkan atau dihilangkan. Jika anggota ini menentukan indeks antarmuka 0, antarmuka multicast default akan digunakan.

Keterangan

Struktur ipv6_mreq digunakan dengan alamat IPv6. Struktur ipv6_mreq digunakan dengan opsi soket IPV6_ADD_MEMBERSHIP, IPV6_DROP_MEMBERSHIP, IPV6_JOIN_GROUP, dan IPV6_LEAVE_GROUP . Opsi soket IPV6_JOIN_GROUP dan IPV6_ADD_MEMBERSHIP didefinisikan sama. Opsi soket IPV6_LEAVE_GROUP dan IPV6_DROP_MEMBERSHIP didefinisikan sama.

Pada Windows Vista dan yang lebih baru, sekumpulan opsi soket tersedia untuk pemrograman multicast yang mendukung alamat IPv6 dan IPv4. Opsi soket ini adalah agnostik IP dan dapat digunakan pada IPv6 dan IPv4. Opsi agnostik IP ini menggunakan GROUP_REQ dan struktur GROUP_SOURCE_REQ dan merupakan opsi soket pilihan untuk pemrograman multicast di Windows Vista dan yang lebih baru.

Struktur ipv6_mreq setara dengan IPv6 dari struktur ip_mreq berbasis IPv4.

Fungsi GetAdaptersAddresses dapat digunakan untuk mendapatkan informasi indeks antarmuka yang diperlukan untuk anggota ipv6mr_interface .

Struktur ipv6_mreq dan opsi soket tingkat IPPROTO_IPV6 yang menggunakan struktur ini hanya valid pada datagram dan soket mentah (jenis soket harus SOCK_DGRAM atau SOCK_RAW).

Disarankan agar indeks antarmuka IPv6 lokal selalu ditentukan dalam anggota ipv6mr_interface struktur ipv6_mreq , daripada menggunakan antarmuka default. Ini sangat penting di komputer dengan beberapa antarmuka jaringan dan beberapa alamat IPv6 publik.

Antarmuka default yang digunakan untuk multicast IPv6 ditentukan oleh tumpukan jaringan di Windows. Pada Windows Vista dan yang lebih baru, aplikasi dapat menentukan antarmuka default yang digunakan untuk multicast IPv6 menggunakan fungsi GetIpForwardTable2 untuk mengambil tabel perutean IPv6. Antarmuka jaringan dengan nilai terendah untuk metrik perutean untuk alamat multicast IPv6 tujuan (blok alamat IPv6 FF00::/8) adalah antarmuka default untuk multicast IPv6. Tabel perutean juga dapat ditampilkan dari prompt perintah dengan perintah berikut:

cetak rute

Opsi soket IPV6_MULTICAST_IF dapat digunakan untuk mengatur antarmuka default untuk mengirim paket multicast IPv6. Opsi soket ini tidak mengubah antarmuka default yang digunakan untuk menerima paket multicast IPv6.

Aplikasi multicast IPv6 yang khas akan menggunakan opsi soket IPV6_ADD_MEMBERSHIP atau IPV6_JOIN_GROUP dengan struktur ipv6_mreq untuk bergabung dengan grup multicast dan mendengarkan paket multicast pada antarmuka tertentu. Opsi soket IPV6_MULTICAST_IF akan digunakan untuk mengatur antarmuka untuk mengirim paket multicast IPv6 ke grup multicast. Skenario yang paling umum adalah aplikasi multicast yang mendengarkan dan mengirim antarmuka yang sama untuk grup multicast. Beberapa soket mungkin digunakan oleh aplikasi multicast dengan satu soket untuk mendengarkan dan satu atau beberapa soket untuk dikirim.

Pada Kit Pengembangan Perangkat Lunak (SDK) Microsoft Windows yang dirilis untuk Windows Vista dan yang lebih baru, organisasi file header telah berubah dan struktur ipv6_mreq ditentukan dalam file header Ws2ipdef.h yang secara otomatis disertakan dalam file header Ws2tcpip.h . File header Ws2ipdef.h tidak boleh digunakan secara langsung.

Catatan Struktur turunan PIP6_MREQ hanya ditentukan pada Windows SDK yang dirilis dengan Windows Vista dan yang lebih baru. GROUP_REQ dan struktur GROUP_SOURCE_REQ dan merupakan opsi soket pilihan untuk pemrograman multicast di Windows Vista dan yang lebih baru.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	ws2ipdef.h (termasuk Ws2tcpip.h)