通过

CheckConnectionWizard 函数 (icwcfg.h)

  • 项目

[此函数不受支持，将来的 Windows 版本中可能会更改或不可用。 ]

CheckConnectionWizard 函数检查 Internet 连接向导 (ICW) 是否已安装，并且以前是否未运行。 CheckConnectionWizard 然后运行 ICW 或返回由提供的运行标志指定的 ICW 状态和 ICW 的任何先前运行的状态。

语法

DWORD CheckConnectionWizard(
  DWORD   unnamedParam1,
  LPDWORD unnamedParam2
);

parameters

unnamedParam1

指示 CheckConnectionWizard 要执行的操作的位标志的组合。

值 含义
ICW_CHECKSTATUS
0x0001
 检查 ICW 是否存在以及它是否已运行。
ICW_LAUNCHFULL
0x0100
 检查 ICW 是否存在以及零售模式 ISP 注册是否可用，如果可能，请运行 ICW。
ICW_LAUNCHMANUAL
0x0200
 检查 ICW 是否存在，在 Internet Explorer 管理员工具包 (IEAK) 展台模式中运行 ICW。
ICW_USE_SHELLNEXT
0x0400
 如果存在零售模式 ISP 注册，请使用 SetShellNext 函数在 ShellNext 注册表项中设置的值运行 ICW。
ICW_FULL_SMARTSTART
0x800
 如果存在 ICW，则零售模式 ISP 注册可用，并且 指定了ICW_LAUNCHFULL ，请使用 smartstart 命令行参数运行 ICW。

unnamedParam2

返回调用结果的 DWORD。 值是以下位标志的组合。

值 含义
ICW_FULLPRESENT
0x0001
 系统上存在零售模式 ISP 注册。
ICW_MANUALPRESENT
0x0002
 存在 IEAK 模式。 如果设置了 ICW_FULLPRESENT ，则始终会设置此值。
ICW_ALREADYRUN
0x0004
 ICW 之前已运行完成。
ICW_LAUNCHEDFULL
0x0100
 零售模式 ISP 注册 ICW 已启动。
ICW_LAUNCHEDMANUAL
0x0200
 ICW 的 IEAK 模式已启动。

返回值

ERROR_SUCCESS 表示调用成功。 任何其他值表示失败。

注解

如果 ICW 存在但尚未运行完成， CheckConnectionWizard 会根据 dwRunFlags 的值执行以下操作之一：返回、在零售模式 ISP 注册中运行完整的 ICW，或在 IEAK 模式下运行 ICW。

零售模式 ISP 注册使用 Icwconn1.exe 运行。 使用 Isign32.exe 运行 IEAK 模式。

注意 如果设置了 ICW_LAUNCHEDFULL 或 ICW_LAUNCHEDMANUAL ，则调用应用程序应退出。 如果需要安装所需的系统软件，ICW 可能会导致系统重新启动。
 

要求

   
目标平台 Windows
标头 icwcfg.h
DLL Inetcfg.dll

另请参阅

SetShellNext