共用方式為

MgmGetProtocolOnInterface 函式 (mgm.h)

  • 發行項

MgmGetProtocolOnInterface 函式會擷取擁有指定介面之多播路由通訊協議的通訊協定標識碼。

語法

DWORD MgmGetProtocolOnInterface(
  [in]      DWORD  dwIfIndex,
  [in]      DWORD  dwIfNextHopAddr,
  [in, out] PDWORD pdwIfProtocolId,
  [in, out] PDWORD pdwIfComponentId
);

參數

[in] dwIfIndex

指定要擷取通訊協定標識碼之介面的索引。

[in] dwIfNextHopAddr

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

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

[in, out] pdwIfProtocolId

在輸入時，客戶端必須提供 DWORD 大小的記憶體位置指標。

在輸出時， pdwIfProtocolId 會在 dwIfIndex 所指定的介面上接收通訊協定的標識符。

[in, out] pdwIfComponentId

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

在輸出時， pdwIfComponentId 會接收介面上通訊協議實例的元件標識碼。 此參數會與 pdwIfProtocolId 搭配使用，以唯一識別路由通訊協議的實例。

傳回值

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

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

值 意義
ERROR_CAN_NOT_COMPLETE
 無法完成此函式的呼叫。
ERROR_NOT_FOUND
 多播群組管理員找不到指定的介面。
 
 

規格需求

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

另請參閱

MgmReleaseInterfaceOwnership

MgmTakeInterfaceOwnership