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

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