GROUP_REQ-Struktur (ws2ipdef.h)
Die GROUP_REQ-Struktur stellt Multicastgruppeninformationen für IPv6- oder IPv4-Adressen bereit.
Syntax
typedef struct group_req {
ULONG gr_interface;
SOCKADDR_STORAGE gr_group;
} GROUP_REQ, *PGROUP_REQ;
Member
gr_interface
Der Schnittstellenindex der lokalen Schnittstelle, auf der die Multicastgruppe verknüpft oder gelöscht werden soll.
gr_group
Die Adresse der Multicastgruppe. Dies kann entweder eine IPv6- oder eine IPv4-Multicastadresse sein.
Hinweise
Die GROUP_REQ-Struktur wird entweder mit IPv6- oder IPv4-Multicastadressen verwendet. Die GROUP_REQ-Struktur wird mit den Socketoptionen MCAST_JOIN_GROUP und MCAST_LEAVE_GROUP verwendet.
Die GROUP_REQ Struktur und die zugehörigen 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 stehen eine Reihe von Socketoptionen für die Multicastprogrammierung zur Verfügung, 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 den gr_interface-Member erforderlich sind.
Die GROUP_REQ-Struktur und die Socketoptionen, die diese Struktur verwenden, sind nur für Datagramme und Unformatierte Sockets gültig (der Sockettyp muss SOCK_DGRAM oder SOCK_RAW sein).
Die GROUP_REQ-Struktur wird in der Ws2ipdef.h-Headerdatei definiert, die automatisch in der Ws2tcpip.h-Headerdatei enthalten ist. Die Ws2ipdef.h-Headerdateien sollten niemals direkt verwendet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Kopfzeile | ws2ipdef.h (include Ws2tcpip.h) |