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)