InternetGetConnectedState Function

---

Retrieves the connected state of the local system.

Syntax

BOOL InternetGetConnectedState(
    OUT LPDWORD lpdwFlags,
    IN DWORD dwReserved
);

Parameters

lpdwFlags

Address of an unsigned long integer variable where the connection description should be returned. This can be a combination of the following values:

INTERNET_CONNECTION_CONFIGURED

Local system has a valid connection to the Internet, but it may or may not be currently connected.

INTERNET_CONNECTION_LAN

Local system uses a local area network to connect to the Internet.

INTERNET_CONNECTION_MODEM

Local system uses a modem to connect to the Internet.

INTERNET_CONNECTION_MODEM_BUSY

No longer used.

INTERNET_CONNECTION_OFFLINE

Local system is in offline mode.

INTERNET_CONNECTION_PROXY

Local system uses a proxy server to connect to the Internet.

INTERNET_RAS_INSTALLED

Local system has RAS installed.

dwReserved

Reserved. Must be set to zero.

Return Value

Returns TRUE if there is an Internet connection, or FALSE otherwise.

Function Information

Windows NT	Use version 4.0. Implemented only as an ANSI function.
Windows	Use Windows 95 and later. Implemented only as an ANSI function.
Header	Wininet.h
Import library	Wininet.lib
Minimum availability	Internet Explorer 4.0

Windows CE

Windows CE	Use version 2.12 and later
Minimum availability	Internet Explorer 4.0

See Also

Microsoft Win32 Internet Functions Overview, Establishing a Dial-Up Connection to the Internet, Microsoft Win32 Internet Functions Reference, Automatic Dialing Functions