RAS_PORT_1 结构

[此版本的 RAS_PORT_1 结构在 Windows Vista 中不受支持。 请改用 mprapi.h 中定义的较新 RAS_PORT_1 。]

RAS_PORT_1 结构包含有关 RAS 端口的信息。

语法

typedef struct _RAS_PORT_1 {
  RAS_PORT_0                rasport0;
  DWORD                     LineCondition;
  DWORD                     HardwareCondition;
  DWORD                     LineSpeed;
  WORD                      NumStatistics;
  WORD                      NumMediaParms;
  DWORD                     SizeMediaParms;
  RAS_PPP_PROJECTION_RESULT ProjResult;
} RAS_PORT_1, *PRAS_PORT_1;

成员

rasport0

指定一个 RAS_PORT_0 结构,该结构包含有关端口的信息,例如端口的名称、连接到端口的远程用户的名称等。

LineCondition

指定端口的状态。 此成员可以是以下值之一。

含义
RAS_PORT_NON_OPERATIONAL
端口不可运行。 检查事件日志中是否有服务器报告的错误。
RAS_PORT_DISCONNECTED
端口当前已断开连接。
RAS_PORT_CALLING_BACK
RAS 服务器正在回调 RAS 客户端。
RAS_PORT_LISTENING
端口正在等待客户端调用。
RAS_PORT_AUTHENTICATING
服务器正在对远程客户端进行身份验证。
RAS_PORT_AUTHENTICATED
远程客户端现在已经过身份验证。
RAS_PORT_INITIALIZING
正在初始化附加到端口的设备。 初始化完成后,端口的状态将更改为RAS_PORT_LISTENING。

HardwareCondition

指定以下值之一,以指示连接到端口的设备的状态。

含义
RAS_MODEM_OPERATIONAL
连接到此端口的调制解调器正常运行,已准备好接收客户端调用。
RAS_MODEM_HARDWARE_FAILURE
连接到此端口的调制解调器存在硬件问题。

LineSpeed

指定计算机可以与端口通信的速度(以位/秒为单位)。

NumStatistics

不使用此成员。 RAS 管理功能(如 RasAdminPortGetInfo 函数)使用 RAS_PORT_STATISTICS 结构返回端口统计信息。

NumMediaParms

指定此端口的媒体特定参数数。 对于串行媒体,这通常是出现在SERIAL.INI文件中的值数。

SizeMediaParms

指定所有特定于媒体的参数所需的缓冲区的大小(以字节为单位)。 RasAdminPortGetInfo 函数返回一个缓冲区,该缓冲区包含RAS_PARAMETERS结构数组,以及端口的媒体参数和值。

ProjResult

一个 RAS_PPP_PROJECTION_RESULT 结构,用于指定此端口的 PPP 投影信息。 此结构提供在 RAS 客户端连接到服务器时协商的每个协议的信息。

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]
客户端支持终止
Windows XP
终止服务器支持
Windows Server 2003
标头
Rassapi.h

另请参阅

远程访问服务 (RAS) 概述

RAS 服务器管理结构

RAS_PARAMETERS

RAS_PORT_0

RAS_PORT_STATISTICS

RAS_PPP_PROJECTION_RESULT

RasAdminAcceptNewConnection

RasAdminConnectionHangupNotification

RasAdminPortGetInfo