共用方式為

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 參數可唯一識別點對多點介面上的下一個躍點。 點對多點介面是一個連接，其中一個介面會連線到多個網路。 點對多點介面的範例包括非廣播多個存取 (NBMA) 介面，以及所有撥號用戶端連線的內部介面。

對於廣播介面 (例如乙太網路介面) 或點對點介面，這些介面只由 dwIfIndex 的值識別，請指定零。

傳回值

如果函式成功，傳回值會NO_ERROR。

如果函式失敗，傳回值就是下列其中一個錯誤碼：

值 意義
ERROR_CAN_NOT_COMPLETE
 無法完成此函式的呼叫。
ERROR_INVALID_PARAMETER
 用戶端的句柄無效，或找不到介面。
 
 

備註

客戶端必須先釋放其擁有的所有介面擁有權，才能使用 MgmDeRegisterMProtocol 函式取消註冊本身。

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 mgm.h
程式庫 Rtm.lib
Dll Rtm.dll

另請參閱

MgmDeRegisterMProtocol

MgmTakeInterfaceOwnership