Fonction InternetGetConnectedStateEx (winineti.h)

Article
08/27/2023

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 renvoyer 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 est possible qu’il ne soit pas actuellement connecté.
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 connexion.

[in] dwNameLen

Taille de la chaîne lpszConnectionName , en TCHAR.

[in] dwReserved

Ce paramètre est réservé et doit avoir la valeur 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 puisse être établie. Les applications doivent toujours case activée pour les 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 n’sont connectés. Si FALSE est retourné, l’indicateur INTERNET_CONNECTION_CONFIGURED peut être défini pour indiquer que laiale automatique est configurée pour « toujours composer », mais qu’elle n’est pas active actuellement. Si laiale automatique n’est pas configurée, 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


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, 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