Function Reference


_WinAPI_GetConnectedDlg

Launches the Get Connected wizard within the calling application to enable network connectivity

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

Parameters

$iDlg Specifies which the dialog should be launched, valid values:
0 - Local area network connectivity.
1 - Internet connectivity.
2 - Virtual private network (VPN) connectivity.
$iFlags [optional] Specifies an additional options. This parameter can be one or more of the following values.
0 - Default.
1 - Do not display the Get Connected wizard page that shows whether or not the user has a working or active Internet connection.
2 - Do not display the Get Connected wizard page that shows a list of existing internet connections.
4 - Hide the finish page of the Get Connected wizard.
$hParent [optional] Handle to the parent window that called this API.

Return Value

Success: 1 - The Internet is connected.
0 - Otherwise.
Failure: 0 and sets the @error flag to non-zero, @extended flag may contain the HRESULT error code.

Remarks

This function requires Windows Vista or later.

Example

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

If _WinAPI_GetVersion() < '6.0' Then
    MsgBox(BitOR($MB_ICONERROR, $MB_SYSTEMMODAL), 'Error', 'Require Windows Vista or later.')
    Exit
EndIf

If _WinAPI_IsInternetConnected() Then
    ConsoleWrite('Internet is already connected.' & @CRLF)
    Exit
EndIf

; Launch the Get Connected wizard within the calling application to enable Internet connectivity
_WinAPI_GetConnectedDlg(1, 1 + 4)