MprAdminInterfaceSetCustomInfoEx 函数 (mprapi.h)

  • 项目

为指定服务器上的指定需求拨号接口设置隧道特定的自定义配置。

语法

DWORD MprAdminInterfaceSetCustomInfoEx(
  [in] MPR_SERVER_HANDLE    hMprServer,
  [in] HANDLE               hInterface,
  [in] PMPR_IF_CUSTOMINFOEX pCustomInfo
);

参数

[in] hMprServer

要查询的路由器的句柄。 此句柄是通过先前对 MprAdminServerConnect 函数的调用获取的。

[in] hInterface

接口的句柄。 此句柄是通过上一次调用 MprAdminInterfaceCreate 函数或 MprAdminInterfaceGetHandle 函数获取的。

[in] pCustomInfo

指向包含隧道特定自定义配置的 MPR_IF_CUSTOMINFOEX 结构的指针。

返回值

如果函数成功，则返回值 NO_ERROR。 如果函数失败，则返回值为以下错误代码之一。

返回代码 说明
ERROR_ACCESS_DENIED
 调用应用程序没有足够的权限。
ERROR_INVALID_HANDLE
 hInterface 值无效。
ERROR_INVALID_PARAMETER
 pCustomInfo 参数为 NULL 或接口类型未ROUTER_IF_TYPE_FULL_ROUTER。
ERROR_NOT_ENOUGH_MEMORY
 资源不足，无法完成该操作。

注解

如果需要删除接口的 IKEv2 隧道的自定义配置，请调用 MprAdminInterfaceSetCustomInfoEx 函数，并将 MPR_IF_CUSTOMINFOEX 结构的 dwFlags 成员设置为零。

如果需要删除接口的 IKEv2 main 模式和快速模式策略配置，请将 MPR_IF_CUSTOMINFOEX 结构中 customIkev2Config 成员的 customPolicy 参数设置为 NULL。

如果需要删除配置为在 IKEv2 main模式 SA 协商期间使用的证书，请将 MPR_IF_CUSTOMINFOEX 结构的 customIkev2Config 成员中 certificateName 的 cbData 成员设置为 0。

要求

要求 值
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2012 [仅限桌面应用]
目标平台 Windows
标头 mprapi.h
Library Mprapi.lib
DLL Mprapi.dll

另请参阅

路由器管理功能

路由器管理参考