ホーム › NetworkManagement.Rras › PMGM_LOCAL_LEAVE_CALLBACK

PMGM_LOCAL_LEAVE_CALLBACK

コールバック

シグネチャ

DWORD PMGM_LOCAL_LEAVE_CALLBACK(
    DWORD dwSourceAddr,
    DWORD dwSourceMask,
    DWORD dwGroupAddr,
    DWORD dwGroupMask,
    DWORD dwIfIndex,
    DWORD dwIfNextHopAddr
);

パラメーター

フィールド	型	説明
dwSourceAddr	DWORD	マルチキャストデータの受信を停止する送信元アドレスを指定します。0 は、すべての送信元からのデータ受信を停止することを示します (グループに対するワイルドカード受信者)。それ以外の場合、dwSourceAddr の値は送信元または送信元ネットワークの IP アドレスです。送信元アドレスの範囲を指定するには、マルチキャストグループマネージャーは dwSourceAddr で送信元ネットワークを指定し、dwSourceMask でサブネットマスクを指定します。
dwSourceMask	DWORD	dwSourceAddr に対応するサブネットマスクを指定します。dwSourceAddr と dwSourceMask の各パラメーターは、マルチキャストデータの受信を停止する送信元の範囲を定義するために組み合わせて使用されます。マルチキャストグループマネージャーは、dwSourceAddr に 0 を指定した場合 (ワイルドカード受信者)、このパラメーターにも 0 を指定します。
dwGroupAddr	DWORD	データの受信を停止するマルチキャストグループを指定します。0 は、すべてのグループのデータ受信を停止することを示します (ワイルドカード受信者)。それ以外の場合、dwGroupAddr の値はグループの IP アドレスです。グループアドレスの範囲を指定するには、マルチキャストグループマネージャーは dwGroupAddr でグループアドレスを指定し、dwGroupMask でサブネットマスクを指定します。
dwGroupMask	DWORD	dwGroupAddr に対応するサブネットマスクを指定します。dwGroupAddr と dwGroupMask の各パラメーターは、マルチキャストグループの範囲を定義するために組み合わせて使用されます。マルチキャストグループマネージャーは、dwGroupAddr に 0 を指定した場合 (ワイルドカード受信者)、このパラメーターにも 0 を指定します。
dwIfIndex	DWORD	マルチキャストデータの受信を停止するインターフェイスを指定します。
dwIfNextHopAddr	DWORD	dwIfIndex で指定されたインデックスに対応するネクストホップのアドレスを指定します。dwIfIndex と dwIfNextHopIPAddr の各パラメーターは、ポイントツーマルチポイントインターフェイス上のネクストホップを一意に識別します。ポイントツーマルチポイントインターフェイスとは、1 つのインターフェイスが複数のネットワークに接続する接続形態です。ポイントツーマルチポイントインターフェイスの例としては、非ブロードキャストマルチアクセス (NBMA) インターフェイスや、すべてのダイヤルアップクライアントが接続する内部インターフェイスが挙げられます。 dwIfIndex の値のみで識別されるブロードキャストインターフェイス (イーサネットインターフェイスなど) やポイントツーポイントインターフェイスの場合は、0 を指定します。

公式ドキュメント

PMGM_LOCAL_LEAVE_CALLBACK コールバックは、現在ルーティングプロトコルが所有しているインターフェイス上で、あるグループの受信者が存在しなくなったことを IGMP が検出したことをルーティングプロトコルに通知するための、ルーティングプロトコルへの呼び出しです。

このコールバックは、IGMP が MgmDeleteGroupMembershipEntry 関数を呼び出したときに呼び出されます。

戻り値

RRAS は、アプリケーションが特定の値を返すことを期待していません。返された値は RRAS によって無視されます。

解説(Remarks)

このバージョンの Multicast Group Manager API は、ワイルドカードの送信元 (*, g) または特定の送信元 (s, g) のみをサポートし、送信元の範囲はサポートしません。同じ制限がグループにも適用されます (つまり、グループの範囲は許可されません)。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)