Share via

Função CheckConnectionWizard (icwcfg.h)

  • Artigo

[Essa função não tem suporte e pode ser alterada ou indisponível em versões futuras do Windows. ]

A função CheckConnectionWizard verifica se o ICW (Assistente de Conexão com a Internet) está instalado e se ele não foi executado antes. CheckConnectionWizard executa o ICW ou retorna o status do ICW conforme especificado pelos sinalizadores de execução fornecidos e o status de qualquer execução anterior do ICW.

Sintaxe

DWORD CheckConnectionWizard(
  DWORD   unnamedParam1,
  LPDWORD unnamedParam2
);

Parâmetros

unnamedParam1

Uma combinação de sinalizadores de bits que indica que a ação CheckConnectionWizard deve ser executada.

Valor Significado
ICW_CHECKSTATUS
0x0001
 Verifique se o ICW está presente e se ele foi executado.
ICW_LAUNCHFULL
0x0100
 Verifique se o ICW está presente e se a inscrição do ISP no modo de varejo está disponível e, se possível, execute o ICW.
ICW_LAUNCHMANUAL
0x0200
 Verifique se o ICW está presente, execute o ICW no modo de quiosque IEAK (Internet Explorer Administrator Kit).
ICW_USE_SHELLNEXT
0x0400
 Se a inscrição do ISP no modo de varejo estiver presente, execute o ICW usando o valor definido na chave do Registro ShellNext pela função SetShellNext .
ICW_FULL_SMARTSTART
0x800
 Se o ICW estiver presente, a inscrição do ISP no modo de varejo estará disponível e ICW_LAUNCHFULL for especificada, execute o ICW com o parâmetro de linha de comando smartstart .

unnamedParam2

DWORD no qual os resultados da chamada são retornados. O valor é uma combinação dos sinalizadores de bit a seguir.

Valor Significado
ICW_FULLPRESENT
0x0001
 A inscrição do ISP no modo de varejo está presente no sistema.
ICW_MANUALPRESENT
0x0002
 O modo IEAK está presente. Isso sempre será definido se ICW_FULLPRESENT estiver definido.
ICW_ALREADYRUN
0x0004
 O ICW foi executado anteriormente até a conclusão.
ICW_LAUNCHEDFULL
0x0100
 O ICW de inscrição do ISP no modo de varejo foi iniciado.
ICW_LAUNCHEDMANUAL
0x0200
 O modo IEAK do ICW foi iniciado.

Valor retornado

ERROR_SUCCESS indica uma chamada bem-sucedida. Qualquer outro valor indica falha.

Comentários

Se o ICW estiver presente, mas não tiver sido executado até a conclusão, CheckConnectionWizard fará um dos seguintes procedimentos com base no valor de dwRunFlags: retorna, executa o ICW completo no modo de varejo inscrição de ISP ou executa o ICW no modo IEAK.

A inscrição do ISP no modo de varejo é executada usando Icwconn1.exe. O modo IEAK é executado usando Isign32.exe.

Nota O aplicativo de chamada deverá sair se ICW_LAUNCHEDFULL ou ICW_LAUNCHEDMANUAL estiver definido. O ICW pode fazer com que o sistema seja reinicializado se o software do sistema necessário precisar ser instalado.
 

Requisitos

   
Plataforma de Destino Windows
Cabeçalho icwcfg.h
DLL Inetcfg.dll

Confira também

SetShellNext