大网数据广告活动
网络与域名解析

RAS_PORT_1 structure (Rassapi.h)

· 52CE 我爱测

The RAS_PORT_1 structure contains information about a RAS port.

[This version of the RAS_PORT_1 structure is not supported as of Windows Vista. Use the newer RAS_PORT_1 defined in mprapi.h instead.]

The RAS_PORT_1 structure contains information about a RAS port.

Syntax

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;

Members

rasport0

Specifies a RAS_PORT_0 structure that contains information about the port, such as the name of the port, the name of the remote user connected to the port, and so on.

LineCondition

Specifies the state of the port. This member can be one of the following values.

Value Meaning
RAS_PORT_NON_OPERATIONAL The port is not operational. Check the event log for errors reported by the server.
RAS_PORT_DISCONNECTED The port is currently disconnected.
RAS_PORT_CALLING_BACK The RAS server is calling back the RAS client.
RAS_PORT_LISTENING The port is waiting for a client to call in.
RAS_PORT_AUTHENTICATING The server is in the process of authenticating the remote client.
RAS_PORT_AUTHENTICATED The remote client is now authenticated.
RAS_PORT_INITIALIZING The device attached to the port is being initialized. The state of the port will change to RAS_PORT_LISTENING when the initialization has been completed.

HardwareCondition

Specifies one of the following values to indicate the state of the device attached to the port.

Value Meaning
RAS_MODEM_OPERATIONAL The modem attached to this port is operational and is ready to receive client calls.
RAS_MODEM_HARDWARE_FAILURE The modem attached to this port has a hardware problem.

LineSpeed

Specifies the speed, in bits per second, with which the computer can communicate with the port.

NumStatistics

This member is not used. The RAS administration functions, such as the RasAdminPortGetInfo function, use the RAS_PORT_STATISTICS structure to return port statistics.

NumMediaParms

Specifies the number of media-specific parameters for this port. For serial media this is typically the number of values that appear in the SERIAL.INI file.

SizeMediaParms

Specifies the size, in bytes, of the buffer required for all media-specific parameters. The RasAdminPortGetInfo function returns a buffer that contains an array of RAS_PARAMETERS structures with the media parameters and values for the port.

ProjResult

A RAS_PPP_PROJECTION_RESULT structure that specifies the PPP projection information for this port. This structure provides information for each protocol that is negotiated when a RAS client connects to a server.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
End of client support Windows XP
End of server support Windows Server 2003
Header Rassapi.h

See also

Remote Access Service (RAS) Overview

RAS Server Administration Structures

RAS_PARAMETERS

RAS_PORT_0

RAS_PORT_STATISTICS

RAS_PPP_PROJECTION_RESULT

RasAdminAcceptNewConnection

RasAdminConnectionHangupNotification

RasAdminPortGetInfo

Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.

资料来源与适用范围

资料来源
Microsoft Learn / Windows Win32 documentation
适用范围
Windows Win32 API · Source date 05/31/2018
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 4.0 (documentation), MIT (code samples)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。