GROUP_SOURCE_REQ 结构 (ws2ipdef.h)

项目
08/28/2023

GROUP_SOURCE_REQ结构为包含源 IP 地址的 IPv6 或 IPv4 地址提供多播组信息。

语法

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

成员

gsr_interface

应联接、删除、阻止或取消阻止多播组的本地接口的接口索引。

gsr_group

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

gsr_source

应使用的源地址。这可能是 IPv6 或 IPv4 多播地址，但它必须是与 gsr_group 成员中指定的 地址 (IPv6 或 IPv4) 相同的地址系列。

注解

GROUP_SOURCE_REQ结构与 IPv6 或 IPv4 多播地址一起使用。 GROUP_SOURCE_REQ 结构与 MCAST_BLOCK_SOURCE、MCAST_JOIN_SOURCE_GROUP、MCAST_LEAVE_SOURCE_GROUP 和 MCAST_UNBLOCK_SOURCE 套接字选项一起使用。

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

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

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

使用此结构的GROUP_SOURCE_REQ结构和套接字选项仅在数据报和原始套接字上有效， (套接字类型必须SOCK_DGRAM或SOCK_RAW) 。

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

要求


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