GROUP_SOURCE_REQ-Struktur (ws2ipdef.h)

Artikel
08/28/2023

Die GROUP_SOURCE_REQ-Struktur stellt Multicastgruppeninformationen für IPv6- oder IPv4-Adressen bereit, die die Quell-IP-Adresse enthalten.

Syntax

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

Member

gsr_interface

Der Schnittstellenindex der lokalen Schnittstelle, in der die Multicastgruppe verknüpft, gelöscht, blockiert oder entsperrt werden soll.

gsr_group

Die Adresse der Multicastgruppe. Dies kann entweder eine IPv6- oder eine IPv4-Multicastadresse sein.

gsr_source

Die Quelladresse, die verwendet werden soll. Dies kann entweder eine IPv6- oder IPv4-Multicastadresse sein, aber es muss die gleiche Adressfamilie (IPv6 oder IPv4) wie die adresse sein, die im gsr_group-Member angegeben ist.

Hinweise

Die GROUP_SOURCE_REQ-Struktur wird mit IPv6- oder IPv4-Multicastadressen verwendet. Die GROUP_SOURCE_REQ-Struktur wird mit den Socketoptionen MCAST_BLOCK_SOURCE, MCAST_JOIN_SOURCE_GROUP, MCAST_LEAVE_SOURCE_GROUP und MCAST_UNBLOCK_SOURCE verwendet.

Die GROUP_SOURCE_REQ Struktur und verwandte Strukturen, die für die Multicastprogrammierung verwendet werden, basieren auf IETF-Empfehlungen in den Abschnitten 5 und 8.2 von RFC 3768. Weitere Informationen finden Sie unter http://www.ietf.org/rfc/rfc3678.txt.

Unter Windows Vista und höher sind eine Reihe von Socketoptionen für die Multicastprogrammierung verfügbar, die IPv6- und IPv4-Adressen unterstützen. Diese Socketoptionen sind IP-unabhängig und können sowohl für IPv6 als auch für IPv4 verwendet werden. Diese ip-unabhängigen Optionen verwenden die GROUP_REQ - und die GROUP_SOURCE_REQ-Strukturen und sind die bevorzugten Socketoptionen für die Multicastprogrammierung unter Windows Vista und höher.

Die GetAdaptersAddresses-Funktion kann verwendet werden, um Schnittstellenindexinformationen abzurufen, die für das gsr_interface-Member erforderlich sind.

Die GROUP_SOURCE_REQ Struktur und die Socketoptionen, die diese Struktur verwenden, sind nur für Datagramme und Rohsockets gültig (der Sockettyp muss SOCK_DGRAM oder SOCK_RAW sein).

Die GROUP_SOURCE_REQ-Struktur wird in der Headerdatei Ws2ipdef.h definiert, die automatisch in der Headerdatei Ws2tcpip.h enthalten ist. Die Ws2ipdef.h-Headerdateien sollten niemals direkt verwendet werden.

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Kopfzeile	ws2ipdef.h (include Ws2tcpip.h)