Fonction InternetAutodial (winineti.h)

  • Article

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