GROUP_SOURCE_REQ struttura (ws2ipdef.h)

La struttura GROUP_SOURCE_REQ fornisce informazioni sul gruppo multicast per indirizzi IPv6 o IPv4 che includono l'indirizzo IP di origine.

Sintassi

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

Members

gsr_interface

Indice dell'interfaccia dell'interfaccia locale in cui deve essere aggiunto il gruppo multicast, eliminato, bloccato o sbloccato.

gsr_group

Indirizzo del gruppo multicast. Può trattarsi di un indirizzo multicast IPv6 o IPv4.

gsr_source

Indirizzo di origine da usare. Può trattarsi di un indirizzo multicast IPv6 o IPv4, ma deve essere la stessa famiglia di indirizzi (IPv6 o IPv4) dell'indirizzo specificato nel membro gsr_group .

Commenti

La struttura GROUP_SOURCE_REQ viene usata con indirizzi multicast IPv6 o IPv4. La struttura GROUP_SOURCE_REQ viene usata con le opzioni socket MCAST_BLOCK_SOURCE, MCAST_JOIN_SOURCE_GROUP, MCAST_LEAVE_SOURCE_GROUP e MCAST_UNBLOCK_SOURCE socket.

La struttura GROUP_SOURCE_REQ e le strutture correlate usate per la programmazione multicast si basano sulle raccomandazioni di IETF nelle sezioni 5 e 8.2 di RFC 3768. Per altre informazioni, vedere http://www.ietf.org/rfc/rfc3678.txt.

In Windows Vista e versioni successive sono disponibili un set di opzioni socket per la programmazione multicast che supporta gli indirizzi IPv6 e IPv4. Queste opzioni di socket sono agnostiche e possono essere usate sia in IPv6 che in IPv4. Queste opzioni ip agnostiche usano le GROUP_REQ e le strutture GROUP_SOURCE_REQ e sono le opzioni di socket preferite per la programmazione multicast in Windows Vista e versioni successive.

La funzione GetAdaptersAddresses può essere usata per ottenere informazioni sull'indice dell'interfaccia necessarie per il membro gsr_interface .

La struttura GROUP_SOURCE_REQ e le opzioni del socket che usano questa struttura sono valide solo per datagram e socket non elaborati (il tipo di socket deve essere SOCK_DGRAM o SOCK_RAW).

La struttura GROUP_SOURCE_REQ è definita nel file di intestazione Ws2ipdef.h che viene incluso automaticamente nel file di intestazione Ws2tcpip.h . I file di intestazione Ws2ipdef.h non devono mai essere usati direttamente.

Requisiti

   
Client minimo supportato Nessuno supportato
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione ws2ipdef.h (includere Ws2tcpip.h)

Vedi anche

GROUP_FILTER

GROUP_REQ

GetAdaptersAddresses

Programmazione multicast

SOCKADDR_STORAGE

Opzioni socket

ip_mreq

ipv6_mreq