CheckConnectionWizard function

[This function is unsupported and may be altered or unavailable in future versions of Windows. ]

The CheckConnectionWizard function checks that the Internet Connection Wizard (ICW) is installed and that it has not been run before. CheckConnectionWizard then either runs the ICW or returns the status of the ICW as specified by the run flags provided and the status of any previous run of the ICW.

Syntax


DWORD CheckConnectionWizard(
   DWORD   dwRunFlags,
   LPDWORD lpdwReturnFlags
);

Parameters

dwRunFlags

A combination of bit flags that indicates the action CheckConnectionWizard is to perform.

ValueMeaning
ICW_CHECKSTATUS
0x0001

Check if the ICW is present and if it has been run.

ICW_LAUNCHFULL
0x0100

Check if the ICW is present and the retail mode ISP signup is available and, if possible, run the ICW.

ICW_LAUNCHMANUAL
0x0200

Check if the ICW is present, run the ICW in Internet Explorer Administrator Kit (IEAK) Kiosk mode.

ICW_USE_SHELLNEXT
0x0400

If the retail mode ISP signup is present, run the ICW using the value set in the ShellNext registry key by SetShellNext function.

ICW_FULL_SMARTSTART
0x800

If the ICW is present, the retail mode ISP signup is available, and ICW_LAUNCHFULL is specified, run the ICW with the smartstart command line parameter.

 

lpdwReturnFlags

DWORD in which the results of the call are returned. The value is a combination of the following bit flags.

ValueMeaning
ICW_FULLPRESENT
0x0001

The retail mode ISP signup is present on the system.

ICW_MANUALPRESENT
0x0002

IEAK mode is present. This is always set if ICW_FULLPRESENT is set.

ICW_ALREADYRUN
0x0004

The ICW has been previously run to completion.

ICW_LAUNCHEDFULL
0x0100

The retail mode ISP signup ICW was started.

ICW_LAUNCHEDMANUAL
0x0200

The IEAK mode of ICW was started.

 

Return value

ERROR_SUCCESS indicates a successful call. Any other value indicates failure.

Remarks

If the ICW is present but has not been run to completion, CheckConnectionWizard does one of the following based on the value of dwRunFlags: returns, runs the full ICW in retail mode ISP signup, or runs ICW in the IEAK mode.

The retail mode ISP signup is run using Icwconn1.exe. IEAK mode is run using Isign32.exe.

Note   The calling application should exit if ICW_LAUNCHEDFULL or ICW_LAUNCHEDMANUAL is set. The ICW may cause the system to reboot if required system software needs to be installed.
 

Requirements

Header

Icwcfg.h

DLL

Inetcfg.dll

See also

SetShellNext

 

 

Show: