IUpdateInstaller::BeginUninstall-Methode (wuapi.h)

Startet eine asynchrone Deinstallation der Updates.

Syntax

HRESULT BeginUninstall(
  [in]  IUnknown         *onProgressChanged,
  [in]  IUnknown         *onCompleted,
  [in]  VARIANT          state,
  [out] IInstallationJob **retval
);

Die Parameter

[in] onProgressChanged

Eine IInstallationProgressChangedCallback-Schnittstelle , die regelmäßig für Deinstallationsfortschrittsänderungen aufgerufen wird, bevor die Deinstallation abgeschlossen ist.

[in] onCompleted

Eine IInstallationCompletedCallback-Schnittstelle , die aufgerufen wird, wenn ein Installationsvorgang abgeschlossen ist.

[in] state

Der aufruferspezifische Zustand, den die IInstallationJob-Schnittstelle der AsyncState-Eigenschaft zurückgibt.

[out] retval

Eine IInstallationJob-Schnittstelle , die die Eigenschaften und Methoden enthält, die für einen asynchronen Deinstallationsvorgang verfügbar sind, der initiiert wurde.

Rückgabewert

Diese Methode gibt die folgenden HRESULT-Werte und andere COM- oder Windows-Werte zurück.

Fehlercodes.

Rückgabecode	Description
S_OK	Die asynchrone Entfernung eines Updates wurde erfolgreich gestartet.
WU_E_INSTALL_NOT_ALLOWED	Rufen Sie diese Methode nicht auf, wenn das Installationsprogramm ein Update installiert oder entfernt. Rufen Sie diese Methode nur auf, wenn die IsBusy-Eigenschaft der IUpdateInstaller-SchnittstelleVARIANT_FALSE zurückgibt.
WU_E_NO_UPDATE	Der Windows Update-Agent (WUA) verfügt nicht über Updates in der Sammlung.

Bemerkungen

Wenn Sie diese Methode aus einer Skriptsprache aufrufen, legen Sie den onProgressChanged-Parameter auf den Bezeichner eines Automatisierungsobjekts mit einer Verteiler-ID (DSIPID) von Null (0) fest, die die Rückrufroutine implementiert. Führen Sie dasselbe für den onCompleted-Parameter aus.

Diese Methode gibt WU_E_NO_UPDATE zurück, wenn die Updates-Eigenschaft von IUpdateInstaller nicht festgelegt ist. Diese Methode gibt auch WU_E_NO_UPDATE zurück, wenn die Updates-Eigenschaft auf eine leere Auflistung festgelegt ist.

Wenn Sie eine asynchrone WUA-API in Ihrer App verwenden, müssen Sie möglicherweise einen Timeoutmechanismus implementieren. Weitere Informationen zum Ausführen asynchroner WUA-Vorgänge finden Sie in den Richtlinien für asynchrone WUA-Vorgänge.

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server	Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps]
Zielplattform	Fenster
Header	wuapi.h
Library	Wuguid.lib
DLL	Wuapi.dll

Siehe auch

IUpdateInstaller