GROUP_REQ 結構 (ws2ipdef.h)

發行項
03/04/2024

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_REQ 和 GROUP_SOURCE_REQ 結構，而且是Windows Vista和更新版本上多播程式設計慣用的套接字選項。

GetAdaptersAddresses 函式可用來取得gr_interface成員所需的介面索引資訊。

GROUP_REQ 結構和使用此結構的套接字選項只有在數據報和原始套接字上才有效， (套接字類型必須SOCK_DGRAM或SOCK_RAW) 。

GROUP_REQ結構定義於 Ws2ipdef.h 頭檔中，Ws2tcpip.h 頭檔中會自動包含該頭檔。不應直接使用 Ws2ipdef.h 頭檔。

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
標頭	ws2ipdef.h (包含 Ws2tcpip.h)