Função IsDestinationReachableA (sensapi.h)

A função IsDestinationReachable determina se um destino especificado pode ou não ser alcançado e fornece informações de QOC (Qualidade da Conexão) para um destino.

Windows Vista e posterior, Windows Server 2008 e posterior: Essa função não tem suporte e sempre retorna ERROR_CALL_NOT_IMPLEMENTED.

Sintaxe

BOOL IsDestinationReachableA(
  [in]      LPCSTR    lpszDestination,
  [in, out] LPQOCINFO lpQOCInfo
);

Parâmetros

[in] lpszDestination

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica um destino. O destino pode ser um endereço IP, um nome UNC ou uma URL.

[in, out] lpQOCInfo

Um ponteiro para a estrutura QOCINFO que recebe as informações de QOC (Qualidade da Conexão). Você poderá fornecer um ponteiro NULL se não quiser receber as informações de QOC.

Retornar valor

Código de retorno	Descrição
TRUE	Um destino pode ser alcançado.
FALSE	Um destino não pode ser alcançado. Para obter informações de erro estendidas, chame GetLastError.
ERROR_CALL_NOT_IMPLEMENTED	Essa função não está disponível no Windows Vista.

Comentários

Os aplicativos cliente usam essa função para determinar as informações de QOC antes de prosseguir com as operações de rede. Para computadores autônomos conectados diretamente a uma rede por meio de um ras (servidor de acesso remoto) ou de cartão de rede, essa função gera tráfego de rede mínimo com chamadas RPC para o roteador mais próximo. Para computadores que fazem parte de uma rede em que um destino pode ser alcançado usando RAS ou um gateway de rede, essa função executa ping em um destino para gerar informações de QOC precisas.

Essa função só está disponível para conexões TCP/IP. Um chamador fornece o buffer para a estrutura QOCINFO e deve liberar a memória quando ela não for necessária.

A partir de 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.

Observação

O cabeçalho sensapi.h define IsDestinationReachable 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 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

IsNetworkAlive

QOCINFO