mgmRegisterMProtocol 函式 (mgm.h)

MgmRegisterMProtocol 函式是由用戶端用來向多播群組管理員註冊。 註冊完成時，多播群組管理員會將句柄傳回給用戶端。 用戶端必須在後續的 MGM 函式呼叫中提供此句柄。

語法

DWORD MgmRegisterMProtocol(
  [in]  PROUTING_PROTOCOL_CONFIG prpiInfo,
  [in]  DWORD                    dwProtocolId,
  [in]  DWORD                    dwComponentId,
  [out] HANDLE                   *phProtocol
);

參數

[in] prpiInfo

ROUTING_PROTOCOL_CONFIG 結構的指標，其中包含對用戶端回呼的指標。

[in] dwProtocolId

指定客戶端的識別碼。 每個客戶端的識別碼都是唯一的。

[in] dwComponentId

指定用戶端特定實例的元件標識碼。 此參數會與 dwProtocolId 搭配使用，以唯一識別客戶端的實例。

[out] phProtocol

在輸入時，客戶端必須提供句柄的指標。

在輸出上， phProtocol 會收到客戶端的註冊句柄。 此句柄必須在對多播群組管理員的後續呼叫中使用。

傳回值

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

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

值	意義
ERROR_ALREADY_EXISTS	無法註冊指定的客戶端，因為已有具有相同通訊協定標識碼和元件標識碼的專案。
ERROR_CAN_NOT_COMPLETE	無法完成此函式的呼叫。
ERROR_NOT_ENOUGH_MEMORY	記憶體不足，無法完成這項作業。

 

 

備註

註冊通訊協定是第一個執行多播路由通訊協議的作業。 註冊之後，路由協議應該先取得適當介面的擁有權，再新增或刪除群組成員資格。

在任何指定的時間，只有一個路由通訊協定可以取得介面的擁有權。 多個路由通訊協定可以向多播群組管理員註冊，每個通訊協定都有不同的介面。

規格需求

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

另請參閱

MgmDeRegisterMProtocol

MgmTakeInterfaceOwnership

ROUTING_PROTOCOL_CONFIG