InternetGetConnectedStateEx Function

---

Retrieves the connected state of the specified Internet connection.

Syntax

BOOL InternetGetConnectedStateEx(
    OUT LPDWORD lpdwFlags,
    OUT LPTSTR lpszConnectionName,
    IN DWORD dwNameLen,
    IN DWORD dwReserved
);

The actual syntax of this function varies between its ANSI and Unicode implementations. For more information, see Win32 Internet Functions Syntax.

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.

lpszConnectionName

Address of a string value that receives the connection name.

dwNameLen

Unsigned long integer value that contains the length of the lpszConnectionName string in TCHAR.

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 as ANSI and Unicode functions.
Windows	Use Windows 95 and later. Implemented as ANSI and Unicode functions.
Header	Wininet.h
Import library	Wininet.lib
Minimum availability	Internet Explorer 5 (ANSI and Unicode)

See Also

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