Please enable JavaScript to view this site.

A-Shell Consolidated Reference

Navigation: Subroutines > MIAMEX

MX_CHKPCNET

Scroll Prev Top Next More

xcall MIAMEX, MX_CHKPCNET, status, flags {,clisvr}

MX_CHKPCNET (MIAMEX 176) checks the network state of the local PC (for A-Shell/Windows) or the ATE client.

This function has both a subroutine and a print tab implementation.

Parameters

status  (Signed Num)  [out]

returns a value indicating:

Value

Meaning

0

Not connected to internet

1

Connected to internet

-1

Function not supported: not Windows, ATE not present, or ATE PC version too old

-15

ATE did not respond to request

-98

Unable to link to required function

-99

wininet.dll not found

 

Note that since older versions of A-Shell would not have this function supported, you may want to pre-set status to something like -999 so you don't confuse a non-updated status with a real one (or, use MX_GETVER to check the A-Shell version before calling the function).

Note also for ATE: if A-Shell on the server is 1138.3 or higher, but the ATE PC is not, the function returns STATUS = -1.

flags (Num)  [out]

returns flags which can be interpreted as following:

Symbol

Value

Meaning

INTERNET_CONNECTION_CONFIGURED

&h0040

local system has a valid connection to the Internet, but it might not be connected.

INTERNET_CONNECTION_OFFLINE

&h0020

local system is in offline mode

INTERNET_RAS_INSTALLED

&h0010

 

INTERNET_CONNECTION_PROXY

&h0004

local system uses a proxy server

INTERNET_CONNECTION_LAN

&h0002

local system uses a LAN to connect

INTERNET_CONNECTION_MODEM

&h0001

local system uses a modem to connect

 

clisvr (String, 1)  [in]

may be set to "S" (for server), or "L" (for local, which is the same as server in this context); anything else is treated as meaning "client". The option only has significance in the ATSD environment where the possibility exists of performing the function relative to the ATSD server or the client. In all other cases, the parameter is ignored and the operation is performed relative to the client, or returns an empty string if an applicable client is not present.

See Also