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 检索与返回的错误代码对应的系统错误消息。