Função InternetCheckConnectionA (wininet.h)

[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 InternetCheckConnectionA(
  [in] LPCSTR 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 for definido, ele 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.

Valor retornado

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.

Requisitos

Confira também

Habilitando a funcionalidade da Internet

Funções WinINet