ssCore.SysInfo.getConnectInfo

Return internet connection state information.


Availability:

First available in version 3.0 build 2039.


Input Parameters:

None.


Output Parameters:

isConnected - TRUE if any kind of internet connection is available.

connectionName - The display name of the internet connection.

isOffline - A boolean value that indicates whether the system is running in OFFLINE mode or not.

usingLAN - A boolean value that indicates whether the system is using the LAN for its internet connection.

usingMODEM - A boolean value that indicates whether the system is using a MODEM for its internet connection.

usingProxy - A boolean value that indicates whether the system is using a proxy server for its internet connection.

activeDialupConnections - The number of active dialup connections. This value should be 1 (or higher) when usingModem returns TRUE.


Asynchronous Mode:

When this method is called asynchronously, a return object containing the output parameters is passed to the specified callback function.

ssCore.SysInfo.getConnectInfo( paramsObject [, callbackParamsObject] [, errorParamsObject] );


Synchronous Mode:

When this method is called synchronously, a return object containing the output parameters is returned to the caller immediately.

var returnObject = ssCore.SysInfo.getConnectInfo( paramsObject );


Notes:

None.


Examples:

var return_obj = ssCore.SysInfo.getConnectInfo();

ssDebug.trace(return_obj.isConnected);
ssDebug.trace(return_obj.connectionName);
ssDebug.trace(return_obj.isOffline);
ssDebug.trace(return_obj.usingLAN);
ssDebug.trace(return_obj.usingMODEM);
ssDebug.trace(return_obj.usingProxy);
ssDebug.trace(return_obj.activeDialupConnections);