IUpdateInstaller::BeginInstall-Methode (wuapi.h)

Artikel
08/28/2023

Startet eine asynchrone Installation der Updates.

Syntax

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

Parameter

[in] onProgressChanged

Eine IInstallationProgressChangedCallback-Schnittstelle , die in regelmäßigen Abständen aufgerufen wird, um Änderungen beim Installationsfortschritt zu erzielen, bevor die Installation abgeschlossen ist.

[in] onCompleted

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

[in] state

Der aufruferspezifische Zustand, der von der AsyncState-Eigenschaft der IInstallationJob-Schnittstelle zurückgegeben wird.

[out] retval

Eine IInstallationJob-Schnittstelle , die die Eigenschaften und Methoden enthält, die für einen asynchronen Installationsvorgang 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	Die asynchrone Installation eines Updates wurde erfolgreich gestartet.
WU_E_INSTALL_NOT_ALLOWED	Sie können diese Methode nicht aufrufen, 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 aus einer Skriptsprache aufrufen, legen Sie den onProgressChanged-Parameter auf den Bezeichner eines Automation-Objekts mit einem Dispatch-Bezeichner (DSIPID) von null (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


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