Fonction InternetCheckConnectionA (wininet.h)

Article
08/27/2023

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

Permet à une application de case activée 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 terminée par null qui spécifie l’URL à utiliser pour case activée 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 de sockets est tentée dans l’ordre suivant :

Si lpszUrl n’a pas la valeur NULL, la valeur de l’hôte en est extraite et utilisée pour effectuer un test ping sur cet hôte spécifique.
Si lpszUrl a la valeur 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 de l’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 retournée

Retourne TRUE si une connexion est établie correctement, ou FALSE dans le cas contraire. 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 inconditionnellement hors connexion.

Remarques

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

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

Notes

L’en-tête wininet.h définit InternetCheckConnection comme un 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.

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	wininet.h
Bibliothèque	Wininet.lib
DLL	Wininet.dll

Voir aussi

Activation des fonctionnalités Internet

Fonctions WinINet

Partager via