Função InternetCheckConnectionA (wininet.h)

Artigo
11/20/2024

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

Permite que um aplicativo verifique se uma conexão com a Internet pode ser estabelecida.

Sintaxe

BOOL InternetCheckConnectionA(
  [in] LPCSTR lpszUrl,
  [in] DWORD  dwFlags,
  [in] DWORD  dwReserved
);

Parâmetros

[in] lpszUrl

Ponteiro para um cadeia de caracteresterminada nula que especifica a URL a ser usada para verificar 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 forNULL, 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.

Valor de retorno

Retorna VERDADEIRO 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 é retornado por GetLastError se uma conexão não puder ser feita ou se o banco de dados de soquetes estiver incondicionalmente offline.

Observações

InternetCheckConnection foi preterida. 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 verificar o acesso à Internet.

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

Consulte também

habilitando de funcionalidade da Internet

do WinINet Functions

Compartilhar via