GROUP_REQ 结构 (ws2ipdef.h)

GROUP_REQ结构提供 IPv6 或 IPv4 地址的多播组信息。

语法

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

成员

gr_interface

应联接或删除多播组的本地接口的接口索引。

gr_group

多播组的地址。 这可能是 IPv6 或 IPv4 多播地址。

注解

GROUP_REQ结构用于 IPv6 或 IPv4 多播地址。 GROUP_REQ 结构与 MCAST_JOIN_GROUP 和 MCAST_LEAVE_GROUP 套接字选项一起使用。

用于多播编程 的GROUP_REQ 结构和相关结构基于 RFC 3768 第 5 节和第 8.2 节中的 IETF 建议。 有关详细信息,请参阅 http://www.ietf.org/rfc/rfc3678.txt

在 Windows Vista 及更高版本上,一组套接字选项可用于支持 IPv6 和 IPv4 地址的多播编程。 这些套接字选项与 IP 无关,可用于 IPv6 和 IPv4。 这些与 IP 无关的选项使用 GROUP_REQGROUP_SOURCE_REQ 结构,是 Windows Vista 及更高版本上多播编程的首选套接字选项。

GetAdaptersAddresses 函数可用于获取gr_interface成员所需的接口索引信息。

GROUP_REQ结构和使用此结构的套接字选项仅在数据报和原始套接字上有效, (套接字类型必须SOCK_DGRAMSOCK_RAW) 。

GROUP_REQ 结构在 Ws2ipdef.h 头文件中定义,该文件自动包含在 Ws2tcpip.h 头文件中。 不应直接使用 Ws2ipdef.h 头文件。

要求

要求
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 ws2ipdef.h (包括 Ws2tcpip.h)

另请参阅

GROUP_FILTER

GROUP_SOURCE_REQ

GetAdaptersAddresses

多播编程

SOCKADDR_STORAGE

套接字选项

ip_mreq

ipv6_mreq