Fonction InternetDial (winineti.h)

  • Article

Initie une connexion à Internet à l’aide d’un modem.

Syntaxe

DWORD InternetDial(
  [in]  HWND    hwndParent,
  [in]  LPSTR   lpszConnectoid,
  [in]  DWORD   dwFlags,
  [out] LPDWORD lpdwConnection,
  [in]  DWORD   dwReserved
);

Paramètres

[in] hwndParent

Handle vers la fenêtre parente.

[in] lpszConnectoid

Pointeur vers une chaîne terminée par null qui spécifie le nom de la connexion d’accès à distance à utiliser. Si ce paramètre contient la chaîne vide («  »), l’utilisateur choisit la connexion. Si ce paramètre a la valeur NULL, la fonction se connecte à la connexion automatique.

[in] dwFlags

Options. Ce paramètre peut prendre les valeurs suivantes.

Valeur Signification
INTERNET_AUTODIAL_FORCE_ONLINE
 Force une connexion en ligne.
INTERNET_AUTODIAL_FORCE_UNATTENDED
 Force une connexion Internet sans assistance. Si l’utilisateur doit intervenir, la fonction échoue.
INTERNET_DIAL_FORCE_PROMPT
 Ignore le paramètre « numérotation automatique » et force l’affichage de l’interface utilisateur de numérotation.
INTERNET_DIAL_UNATTENDED
 Se connecte à Internet via un modem, sans afficher d’interface utilisateur, si possible. Sinon, la fonction attend l’entrée de l’utilisateur.
INTERNET_DIAL_SHOW_OFFLINE
 Affiche le bouton Travailler hors connexion au lieu du bouton Annuler dans l’interface utilisateur de numérotation.

[out] lpdwConnection

Pointeur vers une variable qui spécifie le numéro de connexion. Ce numéro est un identificateur unique pour la connexion qui peut être utilisée dans d’autres fonctions, telles qu’InternetHangUp.

[in] dwReserved

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

Valeur retournée

Retourne ERROR_SUCCESS en cas de réussite, ou une valeur d’erreur dans le cas contraire. Le code d’erreur peut être l’une des valeurs suivantes.

Code de retour Description
ERROR_INVALID_PARAMETER
 Un ou plusieurs paramètres sont incorrects.
ERROR_NO_CONNECTION
 Il y a un problème avec la connexion d’accès à distance.
ERROR_USER_DISCONNECTION
 L’utilisateur a cliqué sur le bouton Travailler hors connexion ou Annuler dans la boîte de dialogue connexion Internet.

Remarques

InternetDial ne prend pas en charge les connexions à double numérotation, l’authentification à 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 .
 
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, Winineti.h, Wininet.h, Winineti.h)
Bibliothèque Wininet.lib
DLL Wininet.dll

Voir aussi

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

Fonctions WinINet