sRASStatusMsg

RAS Function Reference

sRASStatusMsg

This function retrieves a string value of the specified status number.

Declare Function sRASStatusMsg Lib "SapphireRAS.dll" (ByVal sStatusText As String, ByVal lStatus As Long) As Long

Parameters

	sStatusText
		A string variable used to store the text description of the status. If the status number was not recognised the value will be 'Unknown Message status_number' where status_number represents the number that the function was called with.
	lStatus
		A long value specifiying the status number to lookup.

Return Values

Returns a number indicating success or failure where 0 is successful. Use sRASErrMsg to get a string version of the error message.

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