Função IsDestinationReachableA (sensapi.h)

Artigo
11/20/2024

A função IsDestinationReachable determina se um destino especificado pode ou não ser atingido 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 um cadeia de caracteresterminada nula que especifica um destino. O destino pode ser um endereço IP, nome UNC ou URL.

[in, out] lpQOCInfo

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

Valor de retorno

Código de retorno	Descrição
verdadeiro	Um destino pode ser alcançado.
falso	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.

Observações

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 que estão diretamente conectados a uma rede por meio de um RAS (cartão de rede ou servidor de acesso remoto), 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 acessado usando RAS ou um gateway de rede, essa função executa ping em um destino para gerar informações precisas de QOC.

Essa função só está disponível para conexões TCP/IP. Um chamador fornece o buffer para a estrutura de 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 Network List Manager em vez dessa função.

Nota

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 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 XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	sensapi.h
biblioteca	Sensapi.lib
de DLL	Sensapi.dll

Consulte também

sobre o serviço de notificação de eventos do sistema

IsNetworkAlive

QOCINFO

Compartilhar via