Fonction InternetDialW (winineti.h)
Initie une connexion à Internet à l’aide d’un modem.
Syntaxe
DWORD InternetDialW(
[in] HWND hwndParent,
[in] LPWSTR lpszConnectoid,
[in] DWORD dwFlags,
[out] DWORD_PTR *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 |
---|---|
|
Force une connexion en ligne. |
|
Force une connexion Internet sans assistance. Si l’intervention de l’utilisateur est nécessaire, la fonction échoue. |
|
Ignore le paramètre « numérotation automatique » et force l’affichage de l’interface utilisateur de numérotation. |
|
Se connecte à Internet via un modem, sans afficher d’interface utilisateur, si possible. Sinon, la fonction attend l’entrée de l’utilisateur. |
|
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 nombre est un identificateur unique pour la connexion qui peut être utilisé dans d’autres fonctions, telles qu’InternetHangUp.
[in] dwReserved
Ce paramètre est réservé et doit avoir la valeur 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 |
---|---|
|
Un ou plusieurs des paramètres sont incorrects. |
|
Il existe un problème avec la connexion d’accès à distance. |
|
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.
Notes
L’en-tête winineti.h définit InternetDial comme un 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.
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 |