Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
InternetGoOnline
Collapse the table of content
Expand the table of content

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.

ValueMeaning
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 codeDescription
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

Minimum supported server

Windows 2000 Server

Header

Wininet.h

Library

Wininet.lib

DLL

Wininet.dll

Unicode and ANSI names

InternetGoOnlineW (Unicode) and InternetGoOnlineA (ANSI)

See also

Establishing a Dial-Up Connection to the Internet
WinINet Functions

 

 

Show:
© 2015 Microsoft