InternetGetConnectedStateEx Function

Retrieves the connected state of the specified Internet connection.

Syntax

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

The actual syntax of this function varies between its ANSI and Unicode implementations. See the Win32 Internet Functions Syntax document for details.

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_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 contains the connection name.

dwNameLen

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

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 and later. 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

Does this content meet your programming needs? Write us!

Back to top