MprConfigInterfaceTransportGetHandle 函式 (mprapi.h)

發行項
02/29/2024

MprConfigInterfaceTransportGetHandle 函式會擷取指定路由器組態中介面傳輸組態的句柄。

語法

DWORD MprConfigInterfaceTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  HANDLE hRouterInterface,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterIfTransport
);

參數

[in] hMprConfig

路由器組態的句柄。藉由呼叫 MprConfigServerConnect 來取得此句柄。

[in] hRouterInterface

介面組態的句柄。呼叫 MprConfigInterfaceCreate、 MprConfigInterfaceGetHandle 或 MprConfigInterfaceEnum 來取得此句柄。

[in] dwTransportId

DWORD 值，描述 phRouterIfTransport 參數中的傳輸組態句柄類型。下表列出 dwTransportId 可接受的值。

值	傳輸 (通訊協定系列)
PID_ATALK	AppleTalk
PID_IP	因特網通訊協定第 4 版
PID_IPX	因特網封包交換
PID_NBF	NetBIOS 框架通訊協定
PID_IPV6	Windows Server 2008 或更新版本：因特網通訊協定第 6 版

[out] phRouterIfTransport

的指標
HANDLE 變數，接收 dwTransportId 參數中指出之這個介面的傳輸組態句柄類型。

傳回值

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

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

值	意義
ERROR_INVALID_PARAMETER	至少符合下列其中一項條件： hMprConfig 為 NULL。 hRouterInterface 為 NULL。 phRouterIfTransport 為 NULL。
ERROR_NOT_ENOUGH_MEMORY	資源不足，無法完成作業。
ERROR_NO_SUCH_INTERFACE	在路由器組態中找不到 hRouterInterface 指定的介面，或未在指定的介面上啟用 dwTransportId 指定的傳輸。
其他	使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。

規格需求

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