RAS_PORT_1 structure
[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 |
|