IsDestinationReachableA, fonction (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 null-terminated 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 de retour
| Retourner le code | Description |
|---|---|
|
Une destination peut être atteinte. |
|
Impossible d’atteindre une destination. Pour obtenir des informations d’erreur étendues, appelez GetLastError. |
|
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 une 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 est disponible uniquement 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 au lieu de cette fonction.
Note
L’en-tête sensapi.h définit IsDestinationReachable comme 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | sensapi.h |
| bibliothèque | Sensapi.lib |
| DLL | Sensapi.dll |