Fonction InternetGetConnectedStateEx (wininet.h)

Article
03/13/2024

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é de la connexion Internet spécifiée.

Syntaxe

BOOL InternetGetConnectedStateEx(
  [out] LPDWORD lpdwFlags,
  [out] LPSTR   lpszConnectionName,
  [in]  DWORD   dwNameLen,
  [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 être une combinaison 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.

[out] lpszConnectionName

Pointeur vers une valeur de chaîne qui reçoit le nom de la connexion.

[in] dwNameLen

Taille de la chaîne lpszConnectionName , en TCHAR.

[in] dwReserved

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

Valeur retournée

Retourne TRUE s’il existe une connexion Internet, 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	wininet.h (inclure Wininet.h, Winineti.h, Wininet.h, Winineti.h)
Bibliothèque	Wininet.lib
DLL	Wininet.dll

Voir aussi

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

Fonctions WinINet

Partager via