sRASStatus

RAS Function Reference

sRASStatus

This function retrieves the current status of the connection.

<DllImport("SapphireRAS.dll")> _
Public Function sRASStatus(ByVal hRasConn As Integer) As Integer
End Function

Parameters

	hRasConn
		An integer variable referencing the handle to the active connection.

Return Values

Returns a number indicating the connection's current state. A value of zero indicates that there is currently no connection initiated. A value of 25 indicates that the connection was lost during the dialing and authentication phase. A value of 1 indicates that the connection was successfully established. Use sRASStatusMsg to get a string version of the connection status.

Status Message Values

Error Number	Message Returned by sRASStatusMsg
0	Not Connected
1	Connected
2	Opening Port
3	Port Opened
4	Connecting Device
5	Device Connected
6	All Devices Connected
7	Authenticating
8	Authenticating
9	Retrying Authenticating
10	Requesting Callback Number
11	Requesting Password Change
12	Starting Projection Phase
13	Starting Link-Speed Calculation
14	Authentication Has Been Acknowledged
15	Starting Reauthentication
16	Authentication Successful
17	Disconnecting For Callback
18	Resetting Modem
19	Waiting For Incomming Call
20	Completed Projection Phase
21	Terminal State Set
22	Retry Authentication State Set
23	Callback State Set
24	Change Password State Set
25	Lost Connection
Other	Unknown Message