Função InternetGetConnectedStateExW (winineti.h)

Artigo
11/20/2024

Observação Não é recomendável usar essa API, use o método INetworkListManager::GetConnectivity.

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

Sintaxe

BOOL InternetGetConnectedStateExW(
  [out] LPDWORD lpdwFlags,
  [out] LPWSTR  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 valores a seguir.

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 de área 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 é mais usado.
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.

Valor de retorno

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

Observações

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 verificar se há erros retornados de chamadas de 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 VERDADEIRO 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 de INTERNET_CONNECTION_CONFIGURED poderá ser definido para indicar que o autodial está configurado como "sempre discar", mas não está ativo no momento. Se o autodial não estiver configurado, a função retornará false.

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

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 winineti.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 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	winineti.h (incluem Wininet.h, Winineti.h, Wininet.h, Winineti.h)
biblioteca	Wininet.lib
de DLL	Wininet.dll

Consulte também

estabelecer uma conexão discada com o da Internet

do WinINet Functions

Compartilhar via