Função InternetCheckConnectionW (wininet.h)

  • Artigo

[InternetCheckConnection está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use NetworkInformation.GetInternetConnectionProfile ou as Interfaces NLM. ]

Permite que um aplicativo marcar se uma conexão com a Internet puder ser estabelecida.

Sintaxe

BOOL InternetCheckConnectionW(
  [in] LPCWSTR lpszUrl,
  [in] DWORD   dwFlags,
  [in] DWORD   dwReserved
);

Parâmetros

[in] lpszUrl

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica a URL a ser usada para marcar a conexão. Esse valor pode ser NULL.

[in] dwFlags

Opções. FLAG_ICC_FORCE_CONNECTION é o único sinalizador disponível no momento. Se esse sinalizador estiver definido, forçará uma conexão. Uma conexão de soquetes é tentada na seguinte ordem:

  • Se lpszUrl não for NULL, o valor do host será extraído dele e usado para executar ping nesse host específico.
  • Se lpszUrl for NULL e houver uma entrada no banco de dados do servidor interno para o servidor mais próximo, o valor do host será extraído da entrada e usado para executar ping nesse servidor.

[in] dwReserved

Esse parâmetro é reservado e deve ser 0.

Retornar valor

Retornará TRUE se uma conexão for feita com êxito ou FALSE caso contrário. Use GetLastError para recuperar o código de erro. ERROR_NOT_CONNECTED será retornado por GetLastError se uma conexão não puder ser feita ou se o banco de dados de soquetes estiver incondicionalmente offline.

Comentários

InternetCheckConnection foi preterido. InternetCheckConnection não funciona em ambientes que usam um servidor proxy Web para acessar a Internet. Dependendo do ambiente, use NetworkInformation.GetInternetConnectionProfile ou as Interfaces NLM para marcar para acesso à Internet.

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 InternetCheckConnection 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
Biblioteca Wininet.lib
DLL Wininet.dll

Confira também

Habilitando a funcionalidade da Internet

Funções WinINet