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 |
标头 |
|