MprAdminInterfaceCreate 函数 (mprapi.h)

项目
08/24/2023

MprAdminInterfaceCreate 函数在指定的服务器上创建接口。

语法

DWORD MprAdminInterfaceCreate(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [in]  LPBYTE            lpbBuffer,
  [out] HANDLE            *phInterface
);

parameters

[in] hMprServer

要对其执行此调用的路由器的句柄。通过调用 MprAdminServerConnect 获取此句柄。

[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 参数指示结构的类型。

[out] phInterface

指向 HANDLE 变量的指针。变量接收句柄，用于管理此接口的所有后续调用。

返回值

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

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

值	含义
ERROR_ACCESS_DENIED	调用应用程序没有足够的权限。
ERROR_DDM_NOT_RUNNING	不支持路由器接口类型，因为动态接口管理器配置为仅在 LAN 上运行。
ERROR_INTERFACE_ALREADY_EXISTS	已存在同名的接口。
ERROR_NOT_ENOUGH_MEMORY	资源不足，无法完成操作。
ERROR_NOT_SUPPORTED	dwLevel 值无效。

注解

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