Lire en anglais

Partager via


InternetDialA, fonction (winineti.h)

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

Syntaxe

DWORD InternetDialA(
  [in]  HWND      hwndParent,
  [in]  LPSTR     lpszConnectoid,
  [in]  DWORD     dwFlags,
  [out] DWORD_PTR *lpdwConnection,
  [in]  DWORD     dwReserved
);

Paramètres

[in] hwndParent

Gérez la fenêtre parente.

[in] lpszConnectoid

Pointeur vers une chaîne null-terminated qui spécifie le nom de la connexion rendez-vous à utiliser. Si ce paramètre contient la chaîne vide ( » « ), l’utilisateur choisit la connexion. Si ce paramètre est NULL, la fonction se connecte à la connexion automatique.

[in] dwFlags

Options. Ce paramètre peut être l’une des 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’intervention de l’utilisateur est requise, la fonction échoue.
INTERNET_DIAL_FORCE_PROMPT
Ignore le paramètre « dial automatiquement » et force l’interface utilisateur de numérotation à afficher.
INTERNET_DIAL_UNATTENDED
Se connecte à Internet via un modem, sans afficher une interface utilisateur, si possible. Sinon, la fonction attend l’entrée de l’utilisateur.
INTERNET_DIAL_SHOW_OFFLINE
Affiche le bouton travail 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 nombre est un identificateur unique pour la connexion qui peut être utilisée dans d’autres fonctions, telles que InternetHangUp.

[in] dwReserved

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

Valeur de retour

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.

Retourner le code Description
ERROR_INVALID_PARAMETER
Un ou plusieurs des paramètres sont incorrects.
ERROR_NO_CONNECTION
Il existe un problème avec la connexion rendez-vous.
ERROR_USER_DISCONNECTION
L’utilisateur a cliqué sur le bouton Travailler hors connexion ou bouton Annuler dans la boîte de dialogue Connexion Internet.

Remarques

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

Remarque à partir de Windows Vista et Windows Server 2008, les fonctions d’accès à distance WinINet utilisent les fonctions RAS pour établir une connexion rendez-vous. 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.
Remarque 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 winineti.h définit InternetDial comme 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.

Exigences

Exigence Valeur
client minimum pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge Windows 2000 Server [applications de bureau uniquement]
plateforme cible Windows
d’en-tête winineti.h (include Wininet.h, Winineti.h, Wininet.h, Winineti.h)
bibliothèque Wininet.lib
DLL Wininet.dll

Voir aussi

établir une connexion rendez-vous à internet

fonctions WinINet