InternetGoOnlineW function (winineti.h)

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 winineti.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 winineti.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