Função InternetGetConnectedStateEx (winineti.h)

  • Artigo
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 InternetGetConnectedStateEx(
  [out] LPDWORD lpdwFlags,
  [out] LPSTR   lpszConnectionName,
  [in]  DWORD   dwNameLen,
  [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.

[in] dwNameLen

Tamanho da cadeia de caracteres lpszConnectionName , em TCHARs.

[in] dwReserved

Esse parâmetro é reservado e deve ser NULL.

Valor retornado

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

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 winineti.h (incluem 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