Fonction IsDestinationReachableA (sensapi.h)

La fonction IsDestinationReachable détermine si une destination spécifiée peut être atteinte ou non et fournit des informations de qualité de connexion (QOC) pour une destination.

Windows Vista et versions ultérieures, Windows Server 2008 et versions ultérieures : Cette fonction n’est pas prise en charge et retourne toujours ERROR_CALL_NOT_IMPLEMENTED.

Syntaxe

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

Paramètres

[in] lpszDestination

Pointeur vers une chaîne terminée par null qui spécifie une destination. La destination peut être une adresse IP, un nom UNC ou une URL.

[in, out] lpQOCInfo

Pointeur vers la structure QOCINFO qui reçoit les informations de qualité de connexion (QOC). Vous pouvez fournir un pointeur NULL si vous ne souhaitez pas recevoir les informations QOC.

Valeur retournée

Code de retour	Description
TRUE	Une destination est accessible.
FALSE	Impossible d’atteindre une destination. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
ERROR_CALL_NOT_IMPLEMENTED	Cette fonction n’est pas disponible sur Windows Vista.

Remarques

Les applications clientes utilisent cette fonction pour déterminer les informations QOC avant de poursuivre les opérations réseau. Pour les ordinateurs autonomes qui sont directement connectés à un réseau via un carte réseau ou un serveur d’accès à distance (RAS), cette fonction génère un trafic réseau minimal avec des appels RPC vers le routeur le plus proche. Pour les ordinateurs qui font partie d’un réseau où une destination peut être atteinte à l’aide de RAS ou d’une passerelle réseau, cette fonction effectue un test ping sur une destination pour générer des informations QOC précises.

Cette fonction n’est disponible que pour les connexions TCP/IP. Un appelant fournit la mémoire tampon pour la structure QOCINFO et doit libérer la mémoire quand elle n’est pas nécessaire.

À compter des applications conçues pour Windows Vista et Windows Server 2008, les développeurs doivent envisager d’utiliser le Gestionnaire de listes réseau à la place de cette fonction.

Notes

L’en-tête sensapi.h définit IsDestinationReachable comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	sensapi.h
Bibliothèque	Sensapi.lib
DLL	Sensapi.dll

Voir aussi

À propos du service de notification d’événements système

IsNetworkAlive

QOCINFO