structure GROUP_REQ (ws2ipdef.h)

Article
03/04/2024

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)