IUpdateInstaller::BeginUninstall-Methode (wuapi.h)

Artikel
03/04/2024

Startet eine asynchrone Deinstallation der Updates.

Syntax

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

Parameter

[in] onProgressChanged

Eine IInstallationProgressChangedCallback-Schnittstelle , die regelmäßig aufgerufen wird, um den Deinstallationsstatus zu ändern, 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 AsyncState-Eigenschaft IInstallationJob-Schnittstelle 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	Beschreibung
S_OK	Das asynchrone Entfernen 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	Windows Update Agent (WUA) enthält keine Updates in der Sammlung.

Hinweise

Wenn Sie diese Methode in einer Skriptsprache aufrufen, legen Sie den onProgressChanged-Parameter auf den Bezeichner eines Automation-Objekts mit einem Dispatch Identifier (DSIPID) von 0 (0) fest, der 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 unter Richtlinien für asynchrone WUA-Vorgänge.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wuapi.h
Bibliothek	Wuguid.lib
DLL	Wuapi.dll

Weitere Informationen

IUpdateInstaller

Freigeben über