Função InternetGoOnlineA (wininet.h)

Artigo
11/20/2024

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

Sintaxe

BOOL InternetGoOnlineA(
  [in] LPCSTR 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.

Valor de retorno

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

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.

Observações

Observaçã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 do Microsoft Windows HTTP Services (WinHTTP).

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

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

Consulte também

estabelecer uma conexão discada com o da Internet

do WinINet Functions

Compartilhar via