struktur GROUP_SOURCE_REQ (ws2ipdef.h)

Artikel
08/28/2023

Struktur GROUP_SOURCE_REQ menyediakan informasi grup multicast untuk alamat IPv6 atau IPv4 yang menyertakan alamat IP sumber.

Sintaks

typedef struct group_source_req {
  ULONG            gsr_interface;
  SOCKADDR_STORAGE gsr_group;
  SOCKADDR_STORAGE gsr_source;
} GROUP_SOURCE_REQ, *PGROUP_SOURCE_REQ;

Anggota

gsr_interface

Indeks antarmuka antarmuka lokal tempat grup multicast harus digabungkan, dihilangkan, diblokir, atau tidak diblokir.

gsr_group

Alamat grup multicast. Ini mungkin alamat multicast IPv6 atau IPv4.

gsr_source

Alamat sumber yang harus digunakan. Ini mungkin alamat multicast IPv6 atau IPv4, tetapi harus merupakan keluarga alamat yang sama (IPv6 atau IPv4) sebagai alamat yang ditentukan dalam anggota gsr_group .

Keterangan

Struktur GROUP_SOURCE_REQ digunakan dengan alamat multicast IPv6 atau IPv4. Struktur GROUP_SOURCE_REQ digunakan dengan opsi soket MCAST_BLOCK_SOURCE, MCAST_JOIN_SOURCE_GROUP, MCAST_LEAVE_SOURCE_GROUP, dan MCAST_UNBLOCK_SOURCE.

Struktur GROUP_SOURCE_REQ dan struktur terkait yang digunakan untuk pemrograman multicast didasarkan pada rekomendasi IETF di bagian 5 dan 8.2 RFC 3768. Untuk informasi selengkapnya, lihat http://www.ietf.org/rfc/rfc3678.txt.

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.

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

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

Struktur GROUP_SOURCE_REQ ditentukan dalam file header Ws2ipdef.h yang secara otomatis disertakan dalam file header Ws2tcpip.h . File header Ws2ipdef.h tidak boleh digunakan secara langsung.

Persyaratan


Klien minimum yang didukung	Tidak ada yang didukung
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	ws2ipdef.h (termasuk Ws2tcpip.h)