Função InternetGetConnectedStateExA (wininet.h)

Nota O uso dessa API não é recomendado, use o método INetworkListManager::GetConnectivity .

 

Recupera o estado conectado da conexão com a Internet especificada.

Sintaxe

BOOL InternetGetConnectedStateExA(
  [out] LPDWORD lpdwFlags,
  [out] LPSTR   lpszConnectionName,
        DWORD   cchNameLen,
  [in]  DWORD   dwReserved
);

Parâmetros

[out] lpdwFlags

Ponteiro para uma variável que recebe a descrição da conexão. Esse parâmetro pode retornar um sinalizador válido mesmo quando a função retorna FALSE. Esse parâmetro pode ser uma combinação dos seguintes valores.

Valor	Significado
INTERNET_CONNECTION_CONFIGURED 0x40	O sistema local tem uma conexão válida com a Internet, mas pode ou não estar conectado no momento.
INTERNET_CONNECTION_LAN 0x02	O sistema local usa uma rede local para se conectar à Internet.
INTERNET_CONNECTION_MODEM 0x01	O sistema local usa um modem para se conectar à Internet.
INTERNET_CONNECTION_MODEM_BUSY 0x08	Não se usa mais.
INTERNET_CONNECTION_OFFLINE 0x20	O sistema local está no modo offline.
INTERNET_CONNECTION_PROXY 0x04	O sistema local usa um servidor proxy para se conectar à Internet.

[out] lpszConnectionName

Ponteiro para um valor de cadeia de caracteres que recebe o nome da conexão.

cchNameLen

TBD

[in] dwReserved

Esse parâmetro é reservado e deve ser NULL.

Retornar valor

Retornará TRUE se houver uma conexão com a Internet ou FALSE se não houver nenhuma conexão com a Internet ou se todas as conexões de Internet possíveis não estiverem ativas no momento. Para obter mais informações, consulte a seção Comentários.

Quando InternetGetConnectedState retorna FALSE, o aplicativo pode chamar GetLastError para recuperar o código de erro.

Comentários

Um valor retornado de TRUE de InternetGetConnectedState indica que pelo menos uma conexão com a Internet está disponível. Ele não garante que uma conexão com um host específico possa ser estabelecida. Os aplicativos sempre devem marcar para erros retornados de chamadas à API que se conectam a um servidor. InternetCheckConnection pode ser chamado para determinar se uma conexão com um destino específico pode ser estabelecida.

Um valor retornado de TRUE indica que a conexão de modem está ativa ou uma conexão LAN está ativa e um proxy está configurado corretamente para a LAN. Um valor retornado de FALSE indica que nem o modem nem a LAN estão conectados. Se FALSE for retornado, o sinalizador INTERNET_CONNECTION_CONFIGURED poderá ser definido para indicar que o autodial está configurado para "sempre discar", mas não está ativo no momento. Se o autodial não estiver configurado, a função retornará FALSE.

Como todos os outros aspectos da API WinINet, essa função não pode ser chamada com segurança de dentro de DllMain ou dos construtores e destruidores de objetos globais.

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 de servidor ou serviços, use Os Serviços HTTP do Microsoft Windows (WinHTTP).

 

Observação

O cabeçalho wininet.h define InternetGetConnectedStateEx 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 (inclua Wininet.h, Winineti.h, Wininet.h, Winineti.h)
Biblioteca	Wininet.lib
DLL	Wininet.dll

Confira também

Estabelecendo uma conexão discada com a Internet

Funções WinINet