通过

MprConfigInterfaceCreate 函数 (mprapi.h)

  • 项目

MprConfigInterfaceCreate 函数在指定的路由器配置中创建路由器接口。

语法

DWORD MprConfigInterfaceCreate(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [in]  LPBYTE lpbBuffer,
  [out] HANDLE *phRouterInterface
);

parameters

[in] hMprConfig

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

[in] dwLevel

一个 DWORD 值，用于描述在 lpbBuffer 参数中构建信息时采用的格式。 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 参数指示结构的类型。

[out] phRouterInterface

指向句柄变量的指针。 此变量接收接口配置的句柄。

返回值

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

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

值 含义
ERROR_INVALID_PARAMETER
 以下至少一个条件成立：
  • hMprConfig 为 NULL
  • dwLevel 不是 0、1、2 或 3。
  • lpbBuffer 为 NULL
  • phRouterInterface 为 NULL
ERROR_NOT_ENOUGH_MEMORY
 资源不足，无法完成操作。
其他
 使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。

注解

MprAdminInterfaceCreate 函数支持 MPR_INTERFACE_2 结构。 但是， MprConfigInterfaceCreate 不会。 若要创建在重新启动后持久存在的请求拨号接口，请使用 MPR_INTERFACE_2 调用 MprAdminInterfaceCreate，然后使用 MPR_INTERFACE_0 或 MPR_INTERFACE_1 调用 MprConfigInterfaceCreate。

要求

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

另请参阅

FormatMessage

MprConfigInterfaceDelete

MprConfigServerConnect

路由器配置函数

路由器管理参考