Função InternetGoOnlineW (wininet.h)

  • Artigo

Solicita ao usuário permissão para iniciar a conexão com uma URL.

Sintaxe

BOOL InternetGoOnlineW(
  [in] LPCWSTR lpszURL,
  [in] HWND    hwndParent,
  [in] DWORD   dwFlags
);

Parâmetros

[in] lpszURL

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica a URL do site para a conexão.

[in] hwndParent

Manipule para a janela pai.

[in] dwFlags

Esse parâmetro pode ser zero ou o sinalizador a seguir.

Valor Significado
INTERNET_GOONLINE_REFRESH
 Esse sinalizador não é usado.

Retornar valor

Se a função for bem-sucedida, ela retornará TRUE.

Se a função falhar, ela retornará FALSE. Os aplicativos podem chamar GetLastError para recuperar o código de erro.

Se as funções falharem, ele poderá retornar o seguinte código de erro:

Código de retorno Descrição
ERROR_INVALID_PARAMETER
 Um ou mais dos parâmetros estão incorretos.

O parâmetro dwFlags contém um valor diferente de zero ou INTERNET_GOONLINE_REFRESH.

Comentários

Nota O WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações ou serviços de servidor, use Os Serviços HTTP do Microsoft Windows (WinHTTP).
 

Observação

O cabeçalho wininet.h define InternetGoOnline como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wininet.h (incluem Wininet.h, Winineti.h, Wininet.h, Winineti.h)
Biblioteca Wininet.lib
DLL Wininet.dll

Confira também

Estabelecer uma conexão discada com a Internet

Funções WinINet