MprConfigServerSetInfo 函数 (mprapi.h)

MprConfigServerSetInfo 函数用于设置 L2TP、PPTP 和 SSTP 端口的端口计数，并在 RRAS 服务未运行时在注册表中启用或禁用 RRAS，以便在系统下次重启时被选取。

语法

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

[in] hMprServer

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

[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_1 和 MPR_SERVER_2 主题中定义的系统支持的限制。如果尝试将 PPTP 端口数设置为 0，则返回此错误。如果标志无效，或者 lpbBuffer 或 hMprServer 为 NULL，则返回此错误。
ERROR_NOT_SUPPORTED	dwLevel 的值无效。
ERROR_INVALID_HANDLE	hMprServer 句柄无效。
其他	使用 FormatMessage 检索与返回的错误代码对应的系统错误消息。

这些对服务器配置的更改是永久性的，但在重启 RRAS 服务器之前对 RRAS 服务器没有影响。