2.2.1.2.228 RASMAN_INFO

  • Article

The RASMAN_INFO structure contains general information regarding a specific RRAS port, such as port status and port name.

 typedef struct _RASMAN_INFO {
   RASMAN_STATUS RI_PortStatus;
   RASMAN_STATE RI_ConnState;
   DWORD RI_LinkSpeed;
   DWORD RI_LastError;
   RASMAN_USAGE RI_CurrentUsage;
   CHAR RI_DeviceTypeConnecting[16];
   CHAR RI_DeviceConnecting[129];
   CHAR RI_szDeviceType[16];
   CHAR RI_szDeviceName[129];
   CHAR RI_szPortName[17];
   RASMAN_DISCONNECT_TYPE RI_DisconnectType;
   DWORD RI_OwnershipFlag;
   DWORD RI_ConnectDuration;
   DWORD RI_BytesReceived;
   CHAR RI_Phonebook[261];
   CHAR RI_PhoneEntry[257];
   HANDLE RI_ConnectionHandle;
   DWORD RI_SubEntry;
   RASDEVICETYPE RI_rdtDeviceType;
   GUID RI_GuidEntry;
   DWORD RI_dwSessionId;
   DWORD RI_dwFlags;
   GUID RI_CorrelationGuid;
 } RASMAN_INFO;

RI_PortStatus: Specifies the status of the port as defined in RASMAN_STATUS (section 2.2.1.1.17) enumeration type. 

RI_ConnState: Specifies the connection state of the port as defined in RASMAN_STATE (section 2.2.1.1.19). 

RI_LinkSpeed: Specifies the link speed in bits per second (bps) of the connection using port as specified by RI_szPortName.

RI_LastError: Specifies the return status as explained in section 2.2.1.2.218 for retcode field.

RI_CurrentUsage: Specifies the current usage of the port as defined in section 2.2.1.1.21.

RI_DeviceTypeConnecting: Specifies a null-terminated ASCII string that indicates the RRAS server device type as specified for the wszDeviceType field of a RASI_PORT_0 (section 2.2.1.2.75) structure. 

RI_DeviceConnecting: Specifies a null-terminated ASCII string that contains the name of the device associated with the port.

RI_szDeviceType: Specifies a null-terminated ASCII string that contains the RRAS server device type as specified for the wszDeviceType field of RASI_PORT_0 structure.

RI_szDeviceName: Specifies a null-terminated ASCII string that contains the name of the device associated with the port.

RI_szPortName: Specifies a null-terminated ASCII string that contains the port name.

RI_DisconnectType: Specifies the disconnect type of the port as defined by the RASMAN_DISCONNECT_TYPE (section 2.2.1.1.20) enumeration type. 

RI_OwnershipFlag: Specifies the process identifier (PID) of the client application that has opened the port.

RI_ConnectDuration: Specifies the duration of the current connection on this port, in milliseconds.

RI_BytesReceived: Specifies the number of bytes received on this port.

RI_Phonebook: Specifies the RRAS Phonebook path for the connection associated with this port.

RI_PhoneEntry: Specifies the RRAS Phonebook entry name for the connection associated with this port.

RI_ConnectionHandle: Specifies a unique 32-bit unsigned integer identifying the connection associated with this port.

RI_SubEntry: Specifies an index to the multilink subentry associated with this port.

RI_rdtDeviceType: Specifies a value giving the RASDEVICETYPE (section 2.2.1.1.16) enumeration type. 

RI_GuidEntry: Specifies a GUID uniquely identifying the connection associated with the port.

RI_dwSessionId: Specifies the unique session ID associated with the port.<158>

RI_dwFlags: Specifies the configuration option of the connection associated with this port.<159>

The value MUST be one of the following values or a bit-wise OR combination of the following values.

Value

Meaning

0x00000001

Connection associated with this port is configured to store the credentials for everyone.

0x00000002

Connection associated with this port is configured as outgoing connection.

RI_CorrelationGuid: Specifies a GUID that uniquely identifies the connection associated with this port.<160>