InternetGoOnlineW function (wininet.h)

Article
02/09/2023

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

Syntax

BOOL InternetGoOnlineW(
  [in] LPCWSTR 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).

Note

The wininet.h header defines InternetGoOnline as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

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