IsNetworkAlive, fonction (sensapi.h)
La fonction IsNetworkAlive détermine si un système local est connecté ou non à un réseau et identifie le type de connexion réseau, par exemple un réseau local, un réseau étendu ou les deux.
Syntaxe
BOOL IsNetworkAlive(
[out] LPDWORD lpdwFlags
);
Paramètres
[out] lpdwFlags
Type de connexion réseau disponible. Ce paramètre peut être l’une des valeurs suivantes :
NETWORK_ALIVE_LAN
L’ordinateur a une ou plusieurs cartes LAN actives.
NETWORK_ALIVE_WAN
L’ordinateur a une ou plusieurs connexions RAS actives.
Valeur retournée
Appelez toujours GetLastError avant de vérifier le code de retour de cette fonction. Si la dernière erreur n’est pas 0, la fonction IsNetworkAlive a échoué et les valeurs TRUE et FALSE suivantes ne s’appliquent pas.
| Code de retour | Description |
|---|---|
|
Si la dernière erreur est 0 et que la fonction retourne TRUE, SENS a déterminé qu’un système local est connecté à un réseau.
Pour plus d’informations sur le type de connexion, consultez le paramètre lpdwFlags . |
|
Si la dernière erreur est 0 et que la fonction retourne FALSE, SENS a déterminé qu’il n’existe aucune connexion. |
Remarques
À 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.
Cette fonction peut être utilisée par une application pour déterminer s’il existe ou non une connectivité réseau avant de procéder aux opérations réseau. Un type de service d’annuaire d’application, de client de messagerie ou de navigateur Internet peut s’adapter à différents types de connectivité réseau. Par exemple, une opération d’impression peut être différée jusqu’à ce qu’une connexion réseau soit disponible.
Il n’est pas toujours pratique pour une application d’appeler IsNetworkAlive pour déterminer si un système local est déconnecté d’un réseau local, car IsNetworkAlive peut être lent et la fonction peut prendre trop de temps pour détecter qu’un système local est déconnecté. Toutefois, IsNetworkAlive peut toujours identifier une connectivité WAN pour le moment.
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 |