IUpdateInstaller::BeginInstall-Methode (wuapi.h)

Startet eine asynchrone Installation der Updates.

Syntax

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

Die Parameter

[in] onProgressChanged

Eine IInstallationProgressChangedCallback-Schnittstelle , die regelmäßig für Installationsfortschrittsänderungen aufgerufen wird, 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.

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

Siehe auch

IUpdateInstaller