Fonction InternetAutodial (winineti.h)

Article
03/04/2024

Provoque le modem à composer automatiquement la connexion Internet par défaut.

Syntaxe

BOOL InternetAutodial(
  [in] DWORD dwFlags,
  [in] HWND  hwndParent
);

Paramètres

[in] dwFlags

Contrôle cette opération. Ce paramètre peut prendre les valeurs suivantes.

Valeur	Signification
INTERNET_AUTODIAL_FAILIFSECURITYCHECK 0x04	Provoque l’échec d’InternetAutodial si le partage de fichiers et d’imprimantes est désactivé pour Windows 95 ou version ultérieure. Windows Server 2008 et Windows Vista : Cet indicateur est obsolète.
INTERNET_AUTODIAL_FORCE_ONLINE 0x01	Force une connexion Internet en ligne.
INTERNET_AUTODIAL_FORCE_UNATTENDED 0x02	Force une connexion Internet sans assistance.
INTERNET_AUTODIAL_OVERRIDE_NET_PRESENT 0x08	Permet à InternetAutodial de composer la connexion modem même lorsqu’une connexion réseau à Internet est présente.

[in] hwndParent

Handle vers la fenêtre parente.

Valeur retournée

Si la fonction réussit, elle retourne TRUE.

Si la fonction échoue, elle retourne FALSE. Les applications peuvent appeler GetLastError pour récupérer le code d’erreur.

Remarques

InternetAutodial ne prend pas en charge les connexions à double numérotation, l’authentification par carte à puce ou les connexions qui nécessitent une certification basée sur le Registre.

Note À compter de Windows Vista et Windows Server 2008, les fonctions d’accès à distance WinINet utilisent les fonctions RAS pour établir une connexion d’accès à distance. WinINet prend en charge les fonctionnalités documentées dans la fonction RasDialDlg .

InternetAutodial ne tente pas de composer s’il existe une connexion d’accès à distance existante sur le système. En outre, s’il existe une connexion LAN existante et qu’InternetAutodial n’est pas configuré pour forcer la numérotation (définissez le INTERNET_AUTODIAL_FORCE_ONLINE dans le paramètre dwFlags ), InternetAutodial ne tente pas de composer la connexion et retourne TRUE.

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

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	winineti.h (inclure Wininet.h)
Bibliothèque	Wininet.lib
DLL	Wininet.dll

Voir aussi

Établissement d’une connexion d’accès à distance à Internet

Fonctions WinINet

Partager via