MprAdminServerSetInfo 函数 (mprapi.h)

MprAdminServerSetInfo 函数用于在 RRAS 服务运行时设置 L2TP、PPTP 和 SSTP 设备的端口数。

语法

DWORD MprAdminServerSetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

参数

[in] hMprServer

要查询的路由器的句柄。 通过调用 MprAdminServerConnect 获取此句柄。

[in] dwLevel

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

结构格式
1 Windows Server 2003 或更高版本: MPR_SERVER_1
2 Windows Server 2008 或更高版本: MPR_SERVER_2

[in] lpbBuffer

指向MPR_SERVER_1的指针
MPR_SERVER_2 结构。 dwLevel 参数指示结构的类型。

返回值

如果函数成功,则返回值 NO_ERROR

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

含义
ERROR_ACCESS_DENIED
调用应用程序没有足够的权限。
ERROR_SUCCESS_REBOOT_REQUIRED
需要重新启动系统才能使此类更改生效。 使用 MprConfigServerSetInfo 调用更改端口计数并重新启动。
ERROR_INVALID_PARAMETER
如果尝试将端口数设置为超过 MPR_SERVER_1MPR_SERVER_2 主题中定义的系统支持的限制。

如果尝试将 PPTP 端口数设置为 0,则返回此错误。

如果标志无效,或者 lpbBufferhMprServerNULL,则返回此错误。

ERROR_DDM_NOT_RUNNING
RRAS 服务未在此服务器上运行。
ERROR_NOT_SUPPORTED
dwLevel 的值无效。
ERROR_INVALID_HANDLE
hMprServer 句柄无效。
其他
使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。

注解

此函数用于设置 L2TP、PPTP 和 SSTP 端口的端口计数,并在服务运行时启用或禁用 RRAS。 这些值是永久性的,这意味着你不必通过调用 MprConfigServerSetInfo 来执行此调用。 请注意,此函数是异步的,因此可能不会立即看到更改的影响。

示例

主题 设置本地 RRAS 服务的 L2TP 和 PPTP 端口 演示了此函数的使用。

要求

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

另请参阅

MPR_SERVER_1

MPR_SERVER_2

MprAdminBufferFree

MprAdminServerConnect

MprAdminServerGetInfo

路由器管理功能

路由器管理参考