InternetCheckConnectionA, fonction (wininet.h)

Article
11/20/2024

[internetCheckConnection est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions ultérieures. Utilisez plutôt NetworkInformation.GetInternetConnectionProfile ou les interfaces NLM . ]

Permet à une application de vérifier si une connexion à Internet peut être établie.

Syntaxe

BOOL InternetCheckConnectionA(
  [in] LPCSTR lpszUrl,
  [in] DWORD  dwFlags,
  [in] DWORD  dwReserved
);

Paramètres

[in] lpszUrl

Pointeur vers une chaîne null-terminated qui spécifie l’URL à utiliser pour vérifier la connexion. Cette valeur peut être NULL.

[in] dwFlags

Options. FLAG_ICC_FORCE_CONNECTION est le seul indicateur actuellement disponible. Si cet indicateur est défini, il force une connexion. Une connexion sockets est tentée dans l’ordre suivant :

Si lpszUrl n’est pasNULL, la valeur de l’hôte est extraite et utilisée pour effectuer un test ping sur cet hôte spécifique.
Si lpszUrl est NULL et qu’il existe une entrée dans la base de données du serveur interne pour le serveur le plus proche, la valeur hôte est extraite de l’entrée et utilisée pour effectuer un test ping sur ce serveur.

[in] dwReserved

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

Valeur de retour

Retourne TRUE si une connexion est établie correctement, ou FALSE sinon. Utilisez GetLastError pour récupérer le code d’erreur. ERROR_NOT_CONNECTED est retourné par GetLastError si une connexion ne peut pas être établie ou si la base de données sockets est sans condition hors connexion.

Remarques

InternetCheckConnection est déconseillé. InternetCheckConnection ne fonctionne pas dans les environnements qui utilisent un serveur proxy web pour accéder à Internet. Selon l’environnement, utilisez NetworkInformation.GetInternetConnectionProfile ou les interfaces NLM pour rechercher l’accès à Internet à la place.

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 wininet.h définit InternetCheckConnection 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	wininet.h
bibliothèque	Wininet.lib
DLL	Wininet.dll

Voir aussi

activation des fonctionnalités Internet

fonctions WinINet

Partager via