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構造体は、Ws2tcpip.h ヘッダーファイルに自動的に含まれる Ws2ipdef.h ヘッダーファイルで定義されます。 Ws2ipdef.h ヘッダーファイルを直接使用しないでください。

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2008 [デスクトップアプリのみ]
Header	ws2ipdef.h (Ws2tcpip.h を含む)