InternetDialA, fonction (winineti.h)
Lance une connexion à Internet à l’aide d’un modem.
DWORD InternetDialA(
[in] HWND hwndParent,
[in] LPSTR lpszConnectoid,
[in] DWORD dwFlags,
[out] DWORD_PTR *lpdwConnection,
[in] DWORD dwReserved
);
[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 |
---|---|
|
Force une connexion en ligne. |
|
Force une connexion Internet sans assistance. Si l’intervention de l’utilisateur est requise, la fonction échoue. |
|
Ignore le paramètre « dial automatiquement » et force l’interface utilisateur de numérotation à afficher. |
|
Se connecte à Internet via un modem, sans afficher une interface utilisateur, si possible. Sinon, la fonction attend l’entrée de l’utilisateur. |
|
Affiche le bouton travail hors connexion |
[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.
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 |
---|---|
|
Un ou plusieurs des paramètres sont incorrects. |
|
Il existe un problème avec la connexion rendez-vous. |
|
L’utilisateur a cliqué sur le bouton Travailler hors connexion ou bouton Annuler dans la boîte de dialogue Connexion Internet. |
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.
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.
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 |