Função IsNetworkAlive (sensapi.h)

  • Artigo

A função IsNetworkAlive determina se um sistema local está ou não conectado a uma rede e identifica o tipo de conexão de rede, por exemplo, uma LAN, WAN ou ambos.

Sintaxe

BOOL IsNetworkAlive(
  [out] LPDWORD lpdwFlags
);

Parâmetros

[out] lpdwFlags

O tipo de conexão de rede disponível. Esse parâmetro pode usar um dos valores a seguir:

NETWORK_ALIVE_LAN

O computador tem um ou mais cartões LAN que estão ativos.

NETWORK_ALIVE_WAN

O computador tem uma ou mais conexões RAS ativas.

Retornar valor

Sempre chame GetLastError antes de verificar o código de retorno dessa função. Se o último erro não for 0, a função IsNetworkAlive falhará e os seguintes valores TRUE e FALSE não se aplicarão.

Código de retorno Descrição
TRUE
 Se o último erro for 0 e a função retornar TRUE, o SENS determinará que um sistema local está conectado a uma rede.

Para obter informações sobre o tipo de conexão, consulte o parâmetro lpdwFlags .
FALSE
 Se o último erro for 0 e a função retornar FALSE, o SENS determinará que não há conexão.

Comentários

Começando com aplicativos projetados para Windows Vista e Windows Server 2008, os desenvolvedores devem considerar o uso do Gerenciador de Listas de Rede em vez dessa função.

Essa função pode ser usada por um aplicativo para determinar se há ou não conectividade de rede antes de prosseguir com as operações de rede. Um tipo de serviço de diretório de aplicativo, cliente de email ou navegador da Internet pode se adaptar a vários tipos de conectividade de rede. Por exemplo, uma operação de impressão pode ser adiada até que uma conexão de rede esteja disponível.

Nem sempre pode ser prático para um aplicativo chamar IsNetworkAlive para determinar se um sistema local está ou não desconectado de uma LAN, pois IsNetworkAlive pode ser lento e pode levar muito tempo para a função detectar que um sistema local está desconectado. No entanto, IsNetworkAlive sempre pode identificar uma conectividade WAN no momento.

Nota Essa função só está disponível para conexões TCP/IP.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho sensapi.h
Biblioteca Sensapi.lib
DLL Sensapi.dll

Confira também

Sobre o Serviço de Notificação de Eventos do Sistema

IsDestinationReachable