InternetGoOnline function

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

Syntax


BOOL InternetGoOnline(
  _In_ LPTSTR lpszURL,
  _In_ HWND   hwndParent,
  _In_ DWORD  dwFlags
);

Parameters

lpszURL [in]

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

hwndParent [in]

Handle to the parent window.

dwFlags [in]

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.

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

Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Wininet.h
Library	Wininet.lib
DLL	Wininet.dll
Unicode and ANSI names	InternetGoOnlineW (Unicode) and InternetGoOnlineA (ANSI)