Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function retrieves the connected state of the local system.

Syntax

BOOL InternetGetConnectedState(
  LPDWORD 
lpdwFlags,
  DWORD 
dwReserved
);

Parameters

lpdwFlags

[out] Pointer to an unsigned long integer variable where the connection description should be returned. The following table shows the possible values. These values can be used in any combination.

Value Description

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

[in] Reserved. Must be set to zero.

Return Value

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

Requirements

Header wininet.h
Library wininet.lib
Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

WinInet Functions