MgmReleaseInterfaceOwnership 関数 (mgm.h)
MgmReleaseInterfaceOwnership 関数は、インターフェイスの所有権を放棄するためにクライアントによって使用されます。 この関数が呼び出されると、マルチキャスト・グループ・マネージャーがクライアントの代わりにおよび指定されたインターフェースに対して保守しているすべての MFE が削除されます。
構文
DWORD MgmReleaseInterfaceOwnership(
[in] HANDLE hProtocol,
[in] DWORD dwIfIndex,
[in] DWORD dwIfNextHopAddr
);
パラメーター
[in] hProtocol
MgmRegisterMProtocol の以前の呼び出しから取得したプロトコルを処理します。
[in] dwIfIndex
解放するインターフェイスのインデックスを指定します。
[in] dwIfNextHopAddr
dwIfIndex で指定されたインデックスに対応する次ホップのアドレスを指定します。 dwIfIndex パラメーターと dwIfNextHopIPAddr パラメーターは、ポイント対マルチポイント インターフェイスの次ホップを一意に識別します。 ポイント対マルチポイント インターフェイスは、1 つのインターフェイスが複数のネットワークに接続する接続です。 ポイント対マルチポイント インターフェイスの例としては、非ブロードキャスト マルチ アクセス (NBMA) インターフェイスと、すべてのダイヤルアップ クライアントが接続する内部インターフェイスがあります。
ブロードキャスト インターフェイス (イーサネット インターフェイスなど) またはポイントツーポイント インターフェイスの場合は、 dwIfIndex の値のみで識別されます。0 を指定します。
戻り値
関数が成功した場合、戻り値はNO_ERROR。
関数が失敗した場合、戻り値は次のいずれかのエラー コードになります。
値 | 意味 |
---|---|
|
この関数の呼び出しを完了できませんでした。 |
|
クライアントへのハンドルが無効であるか、インターフェイスが見つかりませんでした。 |
注釈
クライアントは、 MgmDeRegisterMProtocol 関数を使用して自身を登録解除する前に、所有するすべてのインターフェイスの所有権を解放する必要があります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | サポートなし |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | mgm.h |
Library | Rtm.lib |
[DLL] | Rtm.dll |