GROUP_REQ struttura (ws2ipdef.h)

La struttura GROUP_REQ fornisce informazioni sul gruppo multicast per indirizzi IPv6 o IPv4.

Sintassi

typedef struct group_req {
  ULONG            gr_interface;
  SOCKADDR_STORAGE gr_group;
} GROUP_REQ, *PGROUP_REQ;

Members

gr_interface

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

gr_group

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

Commenti

La struttura GROUP_REQ viene usata con indirizzi multicast IPv6 o IPv4. La struttura GROUP_REQ viene usata con le opzioni MCAST_JOIN_GROUP e MCAST_LEAVE_GROUP socket.

La struttura GROUP_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 gr_interface .

La struttura GROUP_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_REQ è definita nel file di intestazione Ws2ipdef.h incluso automaticamente nel file di intestazione Ws2tcpip.h . I file di intestazione Ws2ipdef.h non devono mai essere usati direttamente.

Requisiti

Requisito Valore
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_SOURCE_REQ

GetAdaptersAddresses

Programmazione multicast

SOCKADDR_STORAGE

Opzioni socket

ip_mreq

ipv6_mreq