InternetGetConnectedStateExA, fonction (winineti.h)

Article
11/20/2024

Remarque L’utilisation de cette API n’est pas recommandée, utilisez la méthode INetworkListManager ::GetConnectivity à la place.

Récupère l’état connecté de la connexion Internet spécifiée.

Syntaxe

BOOL InternetGetConnectedStateExA(
  [out] LPDWORD lpdwFlags,
  [out] LPSTR   lpszConnectionName,
        DWORD   cchNameLen,
  [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 ou non être connecté actuellement.
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.

cchNameLen

TBD

[in] dwReserved

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

Valeur de retour

Retourne TRUE s’il existe une connexion Internet, ou FALSE s’il n’existe aucune connexion Internet, ou si toutes les connexions Internet possibles ne sont pas actives actuellement. Pour plus d’informations, consultez la section Remarques.

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

Remarques

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

Une valeur de retour de 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 local. Une valeur de retour de FALSE indique que ni le modem ni le réseau local ne sont connectés. Si faux est retourné, l’indicateur de INTERNET_CONNECTION_CONFIGURED peut être défini pour indiquer que l’autodial est configuré pour « toujours composer », mais n’est pas actif actuellement. Si l’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.

Remarque 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).

Note

L’en-tête winineti.h définit InternetGetConnectedStateEx 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 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winineti.h (include Wininet.h, Winineti.h, Wininet.h, Winineti.h)
bibliothèque	Wininet.lib
DLL	Wininet.dll

Voir aussi

établir une connexion rendez-vous à internet

fonctions WinINet

Partager via