共用方式為

mgmTakeInterfaceOwnership 函式 (mgm.h)

  • 發行項

MgmTakeInterfaceOwnership 函式是由用戶端 (呼叫，例如在介面上啟用路由協定) 。

任何時間只有一個用戶端可以取得指定介面的擁有權。 此規則的唯一例外是 IGMP。 IGMP 可以與介面上的另一個用戶端共存。

語法

DWORD MgmTakeInterfaceOwnership(
  [in] HANDLE hProtocol,
  [in] DWORD  dwIfIndex,
  [in] DWORD  dwIfNextHopAddr
);

參數

[in] hProtocol

處理從先前呼叫 MgmRegisterMProtocol 取得的通訊協定。

[in] dwIfIndex

指定要取得擁有權之介面的索引。

[in] dwIfNextHopAddr

指定對應至 dwIfIndex 所指定索引之下一個躍點的位址。 dwIfIndex 和 dwIfNextHopIPAddr 參數可唯一識別點對多點介面上的下一個躍點。 點對多點介面是一個連接，其中一個介面會連線到多個網路。 點對多點介面的範例包括非廣播多個存取 (NBMA) 介面，以及所有撥號用戶端連線的內部介面。

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

傳回值

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

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

值 意義
ERROR_ALREADY_EXISTS
 指定的介面已經由另一個路由通訊協定所擁有。
ERROR_CAN_NOT_COMPLETE
 無法完成此函式的呼叫。
ERROR_INVALID_PARAMETER
 用戶端的句柄無效。
ERROR_NOT_ENOUGH_MEMORY
 記憶體不足，無法完成這項作業。
 
 

備註

用戶端只有在向多播群組管理員註冊本身之後，才能取得介面的擁有權，但在它新增群組成員資格專案之前。

規格需求

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

另請參閱

MgmGetProtocolOnInterface

MgmRegisterMProtocol

MgmReleaseInterfaceOwnership