关于 RAS 服务器和端口管理

RAS 服务器管理功能获取有关指定 RAS 服务器及其端口的信息。 这些函数还用于终止指定 RAS 服务器端口上的连接。

MprAdminServerGetInfo 函数返回一个MPR_SERVER_0结构，其中包含有关 RAS 服务器配置的信息。 返回的信息包括当前可用于连接的端口数、当前使用的端口数和服务器版本号。

MprAdminPortEnum 函数检索RAS_PORT_0结构的数组。 每个结构都包含在 RAS 服务器上配置的其中一个端口的信息。 每个端口的信息包括：

• 端口的名称
• 有关连接到端口的设备的信息
• 与端口关联的 RAS 服务器是否为 Windows NT/Windows 2000 服务器
• 端口当前是否正在使用中，以及有关连接的信息（如果已使用）

若要获取特定连接正在使用的端口，请在 hConnection 参数中向 MprAdminPortEnum 传递该连接的句柄。 若要获取连接的句柄，请使用 MprAdminConnectionEnum 函数。 或者，如果已实现 RAS 管理 DLL， 则 MprAdminAcceptNewConnection 和 MprAdminAcceptNewConnection2 函数会在建立连接时接收每个新连接的句柄。

可以调用 MprAdminPortGetInfo 函数来获取有关 RAS 服务器上指定端口的其他信息。 此函数返回一个 RAS_PORT_1 结构，其中包含 RAS_PORT_0 结构和有关端口当前状态的其他信息。 RasAdminPortGetInfo 函数还返回RAS_PARAMETERS结构的数组，这些结构描述与端口关联的任何特定于媒体的键的值。 RAS_PARAMETERS 结构使用 RAS_PARAMS_FORMAT 枚举中的值来指示每个特定于媒体的键的值的格式。

MprAdminPortGetInfo 函数还返回一个RAS_PORT_STATISTICS结构，该结构包含端口上当前连接的各种统计信息计数器（如果有）。 对于属于多链接连接的端口， MprAdminPortGetInfo 返回单个端口的统计信息，以及连接中涉及的所有端口的累积统计信息。 可以使用 MprAdminPortClearStats 函数重置端口的统计信息计数器。 MprAdminPortDisconnect 函数断开正在使用的端口。

使用 MprAdminBufferFree 函数释放 MprAdminPortEnum 和 MprAdminPortGetInfo 函数分配的内存。 使用 MprAdminGetErrorString 函数获取描述 RAS 服务器管理 (RasAdmin) 函数返回的 RAS 错误代码的字符串。