OnlineScores_GetConnectionState

<< Click to Display Table of Contents >>

Navigation:  ThinBASIC Modules > OnLineScores >

OnlineScores_GetConnectionState

 

This functionality is no longer supported.

 

Description

 

Retrieves the connected state of the local system.

 

Syntax

 

iFlag = OnlineScores_GetConnectionState()

 

Returns

 

Number.

Returns %FALSE if there is no Internet connection, or if all possible Internet connections are not currently active.

Returns a value different from %FALSE if there is an active modem or a LAN Internet connection.

See remarks.

 

Parameters

 

Name

Type

Optional

Meaning





 

Remarks

 

A positive return value indicates that at least one connection to the Internet is available. It does not guarantee that a connection to a specific host can be established.

 

A positive return value indicates that either the modem connection is active, or a LAN connection is active and a proxy is properly configured for the LAN.

A return value of %FALSE indicates that neither the modem nor the LAN is connected.

 

A positive return value contains one or more of the following flags set:

%INTERNET_CONNECTION_MODEM

%INTERNET_CONNECTION_LAN

%INTERNET_CONNECTION_PROXY

%INTERNET_CONNECTION_MODEM_BUSY

%INTERNET_RAS_INSTALLED

%INTERNET_CONNECTION_OFFLINE

%INTERNET_CONNECTION_CONFIGURED

 

Use AND to check for active options.

 

Restrictions

 

See also

 

Examples

 

Dim lConFlags   As Long

 

PRINTL "OnLineScores module needs to connect to Internet. Checking connection ..."

lConFlags = OnlineScores_GetConnectionState

If lConFlags = %False Then

  PRINTL "... it seems you are not connected to Internet"

  PRINTL "Press a key to end script"

  WAITKEY

  STOP

Else

  PRINTL "... your public IP is:", OnlineScores_GetTestingData(%OLS_Test_PublicIP)

  Print "... determining connection type: "

  If lConFlags And %OLS_CONNECTION_MODEM Then Print "Modem "

  If lConFlags And %OLS_CONNECTION_LAN   Then Print "Lan "

  If lConFlags And %OLS_CONNECTION_PROXY Then Print "Proxy "

  PRINTL

  PRINTL "... it seems you are connected to Internet so script can proceed."

End If

PRINTL "-----------------------------------------------------------------------"