InternetCheckConnectionW, fonction (wininet.h)
[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 InternetCheckConnectionW(
[in] LPCWSTR 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 sockets est tentée dans l’ordre suivant :
- Si lpszUrl n’a pas la valeur NULL, la valeur de l’hôte est extraite de celui-ci 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 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 case activée d’accès à Internet à la place.
Notes
L’en-tête wininet.h définit InternetCheckConnection en tant qu’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. La combinaison 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
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 |
Bibliothèque | Wininet.lib |
DLL | Wininet.dll |