InternetDialA, fonction (winineti.h)

Article
11/20/2024

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

Note

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

Partager via