Partager via


structure GROUP_REQ (ws2ipdef.h)

La structure GROUP_REQ fournit des informations de groupe de multidiffusion pour les adresses IPv6 ou IPv4.

Syntaxe

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

Membres

gr_interface

Index d’interface de l’interface locale sur laquelle le groupe de multidiffusion doit être joint ou supprimé.

gr_group

Adresse du groupe de multidiffusion. Il peut s’agir d’une adresse de multidiffusion IPv6 ou IPv4.

Remarques

La structure GROUP_REQ est utilisée avec les adresses de multidiffusion IPv6 ou IPv4. La structure GROUP_REQ est utilisée avec les options de socket MCAST_JOIN_GROUP et MCAST_LEAVE_GROUP.

La structure GROUP_REQ et les structures associées utilisées pour la programmation de multidiffusion sont basées sur les recommandations de l’IETF dans les sections 5 et 8.2 de la RFC 3768. Pour plus d’informations, consultez http://www.ietf.org/rfc/rfc3678.txt.

Sur Windows Vista et versions ultérieures, un ensemble d’options de socket est disponible pour la programmation de multidiffusion qui prend en charge les adresses IPv6 et IPv4. Ces options de socket sont indépendantes de l’adresse IP et peuvent être utilisées sur IPv6 et IPv4. Ces options indépendantes de l’adresse IP utilisent les structures GROUP_REQ et GROUP_SOURCE_REQ et sont les options de socket préférées pour la programmation multidiffusion sur Windows Vista et versions ultérieures.

La fonction GetAdaptersAddresses peut être utilisée pour obtenir les informations d’index d’interface requises pour le membre gr_interface .

La structure GROUP_REQ et les options de socket qui utilisent cette structure ne sont valides que sur les sockets bruts et datagrammes (le type de socket doit être SOCK_DGRAM ou SOCK_RAW).

La structure GROUP_REQ est définie dans le fichier d’en-tête Ws2ipdef.h qui est automatiquement inclus dans le fichier d’en-tête Ws2tcpip.h . Les fichiers d’en-tête Ws2ipdef.h ne doivent jamais être utilisés directement.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête ws2ipdef.h (include Ws2tcpip.h)

Voir aussi

GROUP_FILTER

GROUP_SOURCE_REQ

GetAdaptersAddresses

Programmation multidiffusion

SOCKADDR_STORAGE

Socket Options

ip_mreq

ipv6_mreq