UDF > WinAPIEx > Dialog >


_WinAPI_GetConnectedDlg

Lance l'assistant Get Connected à l'intérieur de l'application appelante pour permettre une connexion au réseau

#include <WinAPIDlg.au3>
_WinAPI_GetConnectedDlg ( $iDlg [, $iFlags = 0 [, $hParent = 0]] )

Paramètres

$iDlg Indique quel dialogue doit être lancé, les valeurs valides sont:
0 - Connexion à un réseau local.
1 - Connexion à Internet.
2 - Connexion à un réseau privé virtuel (VPN).
$iFlags [optionnel] Spécifie une des options supplémentaires. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes:
0 - Default.
1 - Ne pas afficher la page de l'assistant Obtenir une Connexion qui montre si oui ou non l'utilisateur dispose d'un travail ou d'une connexion Internet active.
2 - Ne pas afficher la page de l'assistant Obtenir une Connexion qui affiche une liste de connexions internet existantes.
4 - Cacher la page de fin de l'assistant Obtenir une Connexion.
$hParent [optionnel] Handle de la fenêtre parent qui a appelé cette API.

Valeur de retour

Succès: Retourne 1 - Internet est connecté.
Retourne 0 - Sinon.
Échec: Retourne 0 et définit @error <> 0, @extended contient le code d'erreur HRESULT.

Remarque

Cette fonction nécessite Windows Vista ou une version ultérieure.

Exemple

#include <MsgBoxConstants.au3>
#include <WinAPIDiag.au3>
#include <WinAPIDlg.au3>
#include <WinAPISys.au3>

If Number(_WinAPI_GetVersion()) < 6.0 Then
    MsgBox(BitOR($MB_ICONERROR, $MB_SYSTEMMODAL), 'Erreur', 'Requiert Windows Vista ou une version ultérieure.')
    Exit
EndIf

If _WinAPI_IsInternetConnected() Then
    ConsoleWrite('Internet est déjà connecté.' & @CRLF)
    Exit
EndIf

; Lance l'assistant Obtenir une Connexion dans l'application appelante pour permettre une connexion Internet
_WinAPI_GetConnectedDlg(1, 1 + 4)