structure GROUP_SOURCE_REQ (ws2ipdef.h)

Article
08/28/2023

La structure GROUP_SOURCE_REQ fournit des informations de groupe de multidiffusion pour les adresses IPv6 ou IPv4 qui incluent l’adresse IP source.

Syntaxe

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

Membres

gsr_interface

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

gsr_group

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

gsr_source

Adresse source à utiliser. Il peut s’agir d’une adresse de multidiffusion IPv6 ou IPv4, mais il doit s’agir de la même famille d’adresses (IPv6 ou IPv4) que l’adresse spécifiée dans le membre gsr_group .

Remarques

La structure GROUP_SOURCE_REQ est utilisée avec les adresses de multidiffusion IPv6 ou IPv4. La structure GROUP_SOURCE_REQ est utilisée avec les options de socket MCAST_BLOCK_SOURCE, MCAST_JOIN_SOURCE_GROUP, MCAST_LEAVE_SOURCE_GROUP et MCAST_UNBLOCK_SOURCE.

La structure GROUP_SOURCE_REQ et les structures associées utilisées pour la programmation multidiffusion sont basées sur les recommandations de l’IETF des 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 sont disponibles pour la programmation multidiffusion qui prend en charge les adresses IPv6 et IPv4. Ces options de socket sont indépendantes des adresses 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 gsr_interface .

La structure GROUP_SOURCE_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_SOURCE_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.

Spécifications


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)