MprConfigTransportGetHandle 函式 (mprapi.h)

MprConfigTransportGetHandle 函式會擷取指定路由器組態中指定傳輸通訊協定組態的句柄。

語法

DWORD MprConfigTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterTransport
);

[in] hMprConfig

路由器組態的句柄。句柄是從先前呼叫 MprConfigServerConnect 取得。

[in] dwTransportId

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

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

[out] phRouterTransport

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

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

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

值	意義
ERROR_INVALID_PARAMETER	hMprConfig 參數和/或 phRouterTransport 參數為 NULL。
ERROR_NOT_ENOUGH_MEMORY	資源不足，無法完成作業。
ERROR_UNKNOWN_PROTOCOL_ID	在路由器組態中找不到 dwTransportId 指定的傳輸通訊協定。
其他	使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。