Share via


InternetGetConnectedStateEx

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This function retrieves the connected state of the specified Internet connection.

Syntax

BOOL InternetGetConnectedStateEx(
  LPDWORD lpdwFlags,
  LPTSTR lpszConnectionName,
  DWORD dwNameLen,
  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.

  • lpszConnectionName
    [out] Pointer to a string value that receives the connection name.
  • dwNameLen
    [in] Unsigned long integer value that contains the length of the lpszConnectionName string in TCHAR.
  • 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 .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

WinInet Functions