IPV6_MREQ構造体 (ws2ipdef.h)

[アーティクル]
08/28/2023

ipv6_mreq構造体は、IPv6 アドレスのマルチキャストグループ情報を提供します。

構文

typedef struct ipv6_mreq {
  IN6_ADDR ipv6mr_multiaddr;
  ULONG    ipv6mr_interface;
} IPV6_MREQ, *PIPV6_MREQ;

メンバー

ipv6mr_multiaddr

IPv6 マルチキャストグループのアドレス。

ipv6mr_interface

マルチキャストグループを参加または削除する必要があるローカルインターフェイスのインターフェイスインデックス。このメンバーがインターフェイスインデックス 0 を指定した場合、既定のマルチキャストインターフェイスが使用されます。

注釈

ipv6_mreq構造体は、IPv6 アドレスと共に使用されます。 ipv6_mreq構造体は、IPV6_ADD_MEMBERSHIP、IPV6_DROP_MEMBERSHIP、IPV6_JOIN_GROUP、およびIPV6_LEAVE_GROUPソケットオプションと共に使用されます。 IPV6_JOIN_GROUPとIPV6_ADD_MEMBERSHIPソケットオプションは同じに定義されています。 IPV6_LEAVE_GROUPとIPV6_DROP_MEMBERSHIPソケットオプションは同じに定義されています。

Windows Vista 以降では、IPv6 アドレスと IPv4 アドレスをサポートするマルチキャストプログラミングに一連のソケットオプションを使用できます。これらのソケットオプションは IP に依存せず、IPv6 と IPv4 の両方で使用できます。これらの IP に依存しないオプションでは、GROUP_REQ と GROUP_SOURCE_REQ 構造が使用され、Windows Vista 以降でのマルチキャストプログラミングに推奨されるソケットオプションです。

ipv6_mreq構造体は、IPv4 ベースのip_mreq構造体と同等の IPv6 です。

GetAdaptersAddresses 関数を使用すると、ipv6mr_interface メンバーに必要なインターフェイスインデックス情報を取得できます。

この構造体を使用するipv6_mreq構造体とIPPROTO_IPV6 レベルのソケットオプションは、データグラムと未加工のソケットでのみ有効です (ソケットの種類はSOCK_DGRAMまたはSOCK_RAWする必要があります)。

ローカル IPv6 インターフェイスインデックスは、既定のインターフェイスを使用するのではなく、常に ipv6_mreq 構造体の ipv6mr_interface メンバーで指定することをお勧めします。これは、複数のネットワークインターフェイスと複数のパブリック IPv6 アドレスを持つコンピューターで特に重要です。

IPv6 マルチキャストに使用される既定のインターフェイスは、Windows のネットワークスタックによって決まります。 Windows Vista 以降では、アプリケーションは GetIpForwardTable2 関数を使用して IPv6 ルーティングテーブルを取得する IPv6 マルチキャストに使用される既定のインターフェイスを決定できます。宛先 IPv6 マルチキャストアドレス (FF00::/8 IPv6 アドレスブロック) のルーティングメトリックの最小値を持つネットワークインターフェイスは、IPv6 マルチキャストの既定のインターフェイスです。次のコマンドを使用して、コマンドプロンプトからルーティングテーブルを表示することもできます。

route print

IPV6_MULTICAST_IF ソケットオプションを使用して、IPv6 マルチキャストパケットを送信する既定のインターフェイスを設定できます。このソケットオプションでは、IPv6 マルチキャストパケットの受信に使用される既定のインターフェイスは変更されません。

一般的な IPv6 マルチキャストアプリケーションでは、 IPV6_ADD_MEMBERSHIP または IPV6_JOIN_GROUP ソケットオプションと ipv6_mreq 構造を使用して、マルチキャストグループに参加し、特定のインターフェイスでマルチキャストパケットをリッスンします。 IPV6_MULTICAST_IF ソケットオプションを使用して、IPv6 マルチキャストパケットをマルチキャストグループに送信するインターフェイスを設定します。最も一般的なシナリオは、マルチキャストグループの同じインターフェイスでリッスンして送信するマルチキャストアプリケーションです。マルチキャストアプリケーションでは、リッスン用のソケットが 1 つ、送信用に 1 つ以上のソケットが含まれた複数のソケットが使用される場合があります。

Windows Vista 以降用にリリースされた Microsoft Windows ソフトウェア開発キット (Windows SDK) (SDK) では、ヘッダーファイルのorganizationが変更され、ws2ipdef.h ヘッダーファイルに自動的に含まれる Ws2ipdef.h ヘッダーファイルでipv6_mreq構造が定義されます。 Ws2ipdef.h ヘッダーファイルを直接使用しないでください。

メモPIP6_MREQ派生構造体は、Windows Vista 以降でリリースされたWindows SDKでのみ定義されます。 GROUP_REQと GROUP_SOURCE_REQ 構造体とは、Windows Vista 以降でのマルチキャストプログラミングに推奨されるソケットオプションです。

要件

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