CheckConnectionWizard-Funktion (icwcfg.h)

Artikel
08/24/2023

[Diese Funktion wird nicht unterstützt und kann in zukünftigen Versionen von Windows geändert oder nicht verfügbar sein. ]

Die Funktion CheckConnectionWizard überprüft, ob der Internetverbindungs-Assistent (ICW) installiert ist und noch nicht ausgeführt wurde. CheckConnectionWizard führt dann entweder die ICW aus oder gibt die status der ICW zurück, wie durch die bereitgestellten Ausführungsflags und die status einer vorherigen Ausführung der ICW angegeben.

Syntax

DWORD CheckConnectionWizard(
  DWORD   unnamedParam1,
  LPDWORD unnamedParam2
);

Parameter

unnamedParam1

Eine Kombination aus Bitflags, die angibt, dass die Aktion CheckConnectionWizard ausgeführt werden soll.

Wert	Bedeutung
ICW_CHECKSTATUS 0x0001	Überprüfen Sie, ob die ICW vorhanden ist und ob sie ausgeführt wurde.
ICW_LAUNCHFULL 0x0100	Überprüfen Sie, ob die ICW vorhanden ist und die ISP-Registrierung im Einzelhandelsmodus verfügbar ist, und führen Sie nach Möglichkeit die ICW aus.
ICW_LAUNCHMANUAL 0x0200	Überprüfen Sie, ob das ICW vorhanden ist, und führen Sie die ICW im Kioskmodus internet Explorer Administrator Kit (IEAK) aus.
ICW_USE_SHELLNEXT 0x0400	Wenn die ISP-Registrierung im Einzelhandelsmodus vorhanden ist, führen Sie den ICW mit dem Wert aus, der im Registrierungsschlüssel ShellNext von SetShellNext festgelegt wurde.
ICW_FULL_SMARTSTART 0x800	Wenn die ICW vorhanden ist, ist die ISP-Registrierung im Einzelhandelsmodus verfügbar, und ICW_LAUNCHFULL angegeben ist, führen Sie die ICW mit dem Smartstart-Befehlszeilenparameter aus.

unnamedParam2

DWORD , in dem die Ergebnisse des Aufrufs zurückgegeben werden. Der Wert ist eine Kombination der folgenden Bitflags.

Wert	Bedeutung
ICW_FULLPRESENT 0x0001	Die ISP-Registrierung im Einzelhandelsmodus ist auf dem System vorhanden.
ICW_MANUALPRESENT 0x0002	Der IEAK-Modus ist vorhanden. Dies wird immer festgelegt, wenn ICW_FULLPRESENT festgelegt ist.
ICW_ALREADYRUN 0x0004	Die ICW wurde zuvor bis zum Abschluss ausgeführt.
ICW_LAUNCHEDFULL 0x0100	Die ICW für die ISP-Registrierung im Einzelhandelsmodus wurde gestartet.
ICW_LAUNCHEDMANUAL 0x0200	Der IEAK-Modus von ICW wurde gestartet.

Rückgabewert

ERROR_SUCCESS gibt einen erfolgreichen Aufruf an. Alle anderen Werte geben einen Fehler an.

Hinweise

Wenn die ICW vorhanden, aber noch nicht bis zum Abschluss ausgeführt wurde, führt CheckConnectionWizard basierend auf dem Wert von dwRunFlags eine der folgenden Aktionen aus: Gibt zurück, führt die vollständige ICW in der ISP-Registrierung im Einzelhandelsmodus aus oder führt ICW im IEAK-Modus aus.

Die ISP-Registrierung im Einzelhandelsmodus wird mit Icwconn1.exe ausgeführt. Der IEAK-Modus wird mit Isign32.exe ausgeführt.

Hinweis Die aufrufende Anwendung sollte beendet werden, wenn ICW_LAUNCHEDFULL oder ICW_LAUNCHEDMANUAL festgelegt ist. Die ICW kann dazu führen, dass das System neu gestartet wird, wenn die erforderliche Systemsoftware installiert werden muss.

Requirements (Anforderungen)


Zielplattform	Windows
Kopfzeile	icwcfg.h
DLL	Inetcfg.dll

Weitere Informationen

SetShellWeiter

Freigeben über