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.
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
| 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 |