MprConfigInterfaceGetHandle 函式 (mprapi.h)

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

語法

DWORD MprConfigInterfaceGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  LPWSTR lpwsInterfaceName,
  [out] HANDLE *phRouterInterface
);

[in] hMprConfig

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

[in] lpwsInterfaceName

Null 終止 Unicode 字串的指標，指定要求組態句柄之介面的名稱。使用介面 GUID 作為 LAN 介面的名稱。

[out] phRouterInterface

句柄變數的指標。此變數會接收介面組態的句柄。

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

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

值	意義
ERROR_INVALID_PARAMETER	hMprConfig 參數為 NULL，或 lpwsInterfaceName 參數為 NULL，或兩個參數都是 NULL。
ERROR_NOT_ENOUGH_MEMORY	資源不足，無法完成作業。
ERROR_NO_SUCH_INTERFACE	在路由器組態中找不到指定的介面。
其他	使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。