Fonction InternetDialA (winineti.h)

Article
08/27/2023

Initie 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

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’intervention de l’utilisateur est nécessaire, 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 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
ERROR_INVALID_PARAMETER	Un ou plusieurs des paramètres sont incorrects.
ERROR_NO_CONNECTION	Il existe 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).

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


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

Partager via