RAS 服务器和端口管理

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

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

RasAdminPortEnum 函数检索 RAS_PORT_0 结构的数组,其中包含 RAS 服务器上配置的每个端口的信息。 每个端口的信息包括:

  • 端口的名称
  • 有关附加到端口的设备的信息
  • 与端口关联的 RAS 服务器是否为 Windows NT/Windows 2000 Server
  • 端口当前是否正在使用,如果是,则有关连接的信息

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

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

使用 RasAdminFreeBuffer 函数释放由 RasAdminPortEnumRasAdminPortGetInfo 函数分配的内存。 使用 RasAdminGetErrorString 函数获取描述 RAS 服务器管理(RasAdmin)函数返回的 RAS 错误代码的字符串。