MprConfigInterfaceSetInfo 函数 (mprapi.h)

项目
08/24/2023

MprConfigInterfaceSetInfo 函数设置指定接口的配置。

语法

DWORD MprConfigInterfaceSetInfo(
  [in] HANDLE hMprConfig,
  [in] HANDLE hRouterInterface,
  [in] DWORD  dwLevel,
  [in] LPBYTE lpbBuffer
);

参数

[in] hMprConfig

路由器配置的句柄。通过调用 MprConfigServerConnect 获取此句柄。

[in] hRouterInterface

正在更新的接口配置的句柄。通过调用 MprConfigInterfaceCreate、 MprConfigInterfaceGetHandle 或 MprConfigInterfaceEnum 获取此句柄。

[in] dwLevel

一个 DWORD 值，用于描述 在 lpBuffer 参数中构建信息的格式。 dwLevel 的可接受值包括 0、1、2 和 3，如下表所示。

值	结构格式
0	MPR_INTERFACE_0
1	MPR_INTERFACE_1
2	MPR_INTERFACE_2
3	Windows Server 2008 或更高版本： MPR_INTERFACE_3

[in] lpbBuffer

指向
MPR_INTERFACE_0、 MPR_INTERFACE_1、
MPR_INTERFACE_2或 MPR_INTERFACE_3 结构。 dwLevel 参数指示结构的类型。此结构中的信息用于更新接口配置。

返回值

如果函数成功，则返回值 NO_ERROR。

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

值	含义
ERROR_INVALID_PARAMETER	以下至少一个条件成立： hMprConfig 为 NULL。 hRouterInterface 为 NULL。 dwLevel 不是 0、1、2 或 3。 lpBuffer 为 NULL。如果接口的类型为 ROUTER_IF_TYPE_DEDICATED 或 ROUTER_IF_TYPE_INTERNAL 并且接口已启用，则还会返回此错误代码。
ERROR_NO_SUCH_INTERFACE	路由器配置中不存在对应于 hRouterInterface 的接口。
其他	使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。

注解

MprAdminInterfaceSetInfo 函数支持 MPR_INTERFACE_2 结构。但是， MprConfigInterfaceSetInfo 没有。若要对请求拨号接口进行持久更改，请使用 MPR_INTERFACE_2 调用 MprAdminInterfaceSetInfo，然后使用 MPR_INTERFACE_0 或 MPR_INTERFACE_1 调用 MprConfigInterfaceSetInfo。

要求

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