Share via

InternetGetConnectedStateEx

  • Article

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

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 Values

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

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Wininet.h.
Link Library: Wininet.lib.

See Also

WinInet Functions

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.