Partager via


Fonction InternetGetConnectedState (winineti.h)

Note L’utilisation de cette API n’est pas recommandée. Utilisez plutôt la méthode INetworkListManager ::GetConnectivity .
 
Récupère l’état connecté du système local.

Syntaxe

BOOL InternetGetConnectedState(
  [out] LPDWORD lpdwFlags,
  [in]  DWORD   dwReserved
);

Paramètres

[out] lpdwFlags

Pointeur vers une variable qui reçoit la description de la connexion. Ce paramètre peut retourner un indicateur valide même lorsque la fonction retourne FALSE. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Valeur Signification
INTERNET_CONNECTION_CONFIGURED
0x40
Le système local dispose d’une connexion valide à Internet, mais il peut être connecté ou non.
INTERNET_CONNECTION_LAN
0x02
Le système local utilise un réseau local pour se connecter à Internet.
INTERNET_CONNECTION_MODEM
0x01
Le système local utilise un modem pour se connecter à Internet.
INTERNET_CONNECTION_MODEM_BUSY
0x08
N'est plus utilisé.
INTERNET_CONNECTION_OFFLINE
0x20
Le système local est en mode hors connexion.
INTERNET_CONNECTION_PROXY
0x04
Le système local utilise un serveur proxy pour se connecter à Internet.
INTERNET_RAS_INSTALLED
0x10
Ras est installé sur le système local.

[in] dwReserved

Ce paramètre est réservé et doit être 0.

Valeur retournée

Retourne TRUE s’il existe un modem actif ou une connexion Internet LAN, ou FALSE s’il n’y a pas de connexion Internet, ou si toutes les connexions Internet possibles ne sont pas actives actuellement. Pour plus d'informations, consultez la section Notes.

Quand InternetGetConnectedState retourne FALSE, l’application peut appeler GetLastError pour récupérer le code d’erreur.

Remarques

Une valeur de retour TRUE à partir d’InternetGetConnectedState indique qu’au moins une connexion à Internet est disponible. Cela ne garantit pas qu’une connexion à un hôte spécifique peut être établie. Les applications doivent toujours case activée en cas d’erreurs retournées par les appels d’API qui se connectent à un serveur. InternetCheckConnection peut être appelé pour déterminer si une connexion à une destination spécifique peut être établie.

La valeur de retour TRUE indique que la connexion de modem est active ou qu’une connexion LAN est active et qu’un proxy est correctement configuré pour le réseau. La valeur de retour FALSE indique que ni le modem ni le réseau lan ne sont connectés. Si FALSE est retourné, l’indicateur de INTERNET_CONNECTION_CONFIGURED peut être défini pour indiquer que la commande d’autodial est configurée pour « toujours composer », mais qu’elle n’est pas active actuellement. Si autodial n’est pas configuré, la fonction retourne FALSE.

Comme tous les autres aspects de l’API WinINet, cette fonction ne peut pas être appelée en toute sécurité à partir de DllMain ou des constructeurs et destructeurs d’objets globaux.

Note WinINet ne prend pas en charge les implémentations de serveur. En outre, il ne doit pas être utilisé à partir d’un service. Pour les implémentations de serveur ou les services, utilisez Microsoft Windows HTTP Services (WinHTTP).
 

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête winineti.h (inclure Wininet.h)
Bibliothèque Wininet.lib
DLL Wininet.dll

Voir aussi

Établissement d’une connexion d’accès à distance à Internet

Fonctions WinINet