InternetGoOnline function (wininet.h)

Prompts the user for permission to initiate connection to a URL.

Syntax

BOOL InternetGoOnline(
  [in] LPSTR lpszURL,
  [in] HWND  hwndParent,
  [in] DWORD dwFlags
);

Parameters

[in] lpszURL

Pointer to a null-terminated string that specifies the URL of the website for the connection.

[in] hwndParent

Handle to the parent window.

[in] dwFlags

This parameter can be zero or the following flag.

Value Meaning
INTERNET_GOONLINE_REFRESH
This flag is not used.

Return value

If the function succeeds, it returns TRUE.

If the function fails, it returns FALSE. Applications can call GetLastError to retrieve the error code.

If the functions fails, it can return the following error code:

Return code Description
ERROR_INVALID_PARAMETER
One or more of the parameters is incorrect.

The dwFlags parameter contains a value other than zero or INTERNET_GOONLINE_REFRESH.

Remarks

Note  WinINet does not support server implementations. In addition, it should not be used from a service. For server implementations or services use Microsoft Windows HTTP Services (WinHTTP).
 

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header wininet.h (include Wininet.h, Winineti.h, Wininet.h, Winineti.h)
Library Wininet.lib
DLL Wininet.dll

See also

Establishing a Dial-Up Connection to the Internet

WinINet Functions