Metodo IUpdateInstaller::BeginInstall (wuapi.h)

Articolo
08/28/2023

Avvia un'installazione asincrona degli aggiornamenti.

Sintassi

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

Parametri

[in] onProgressChanged

Interfaccia IInstallationProgressChangedCallback chiamata periodicamente per modificare lo stato di avanzamento dell'installazione prima del completamento dell'installazione.

[in] onCompleted

Interfaccia IInstallationCompletedCallback chiamata al completamento di un'operazione di installazione.

[in] state

Stato specifico del chiamante restituito dalla proprietà AsyncState dell'interfaccia IInstallationJob .

[out] retval

Interfaccia IInstallationJob che contiene le proprietà e i metodi disponibili per un'operazione di installazione asincrona avviata.

Valore restituito

Questo metodo restituisce i valori HRESULT seguenti e altri valori COM o Windows

codici di errore.

Codice restituito	Descrizione
S_OK	Installazione asincrona di un aggiornamento avviato correttamente.
WU_E_INSTALL_NOT_ALLOWED	Non è possibile chiamare questo metodo quando il programma di installazione installa o rimuove un aggiornamento. Chiamare questo metodo solo quando la proprietà IsBusy dell'interfaccia IUpdateInstaller restituisce VARIANT_FALSE.
WU_E_NO_UPDATE	Windows Update Agent (WUA) non include aggiornamenti nella raccolta.

Commenti

Se si chiama questo metodo da un linguaggio di scripting, impostare il parametro onProgressChanged sull'identificatore di un oggetto automation con un identificatore dispatch (DSIPID) pari a zero (0) che implementa la routine di callback. Eseguire la stessa operazione per il parametro onCompleted .

Questo metodo restituisce WU_E_NO_UPDATE se la proprietà Aggiornamenti di IUpdateInstaller non è impostata. Questo metodo restituisce anche WU_E_NO_UPDATE se la proprietà Aggiornamenti è impostata su un insieme vuoto.

Quando si usa qualsiasi API WUA asincrona nell'app, potrebbe essere necessario implementare un meccanismo di timeout. Per altre informazioni su come eseguire operazioni WUA asincrone, vedere Linee guida per le operazioni WUA asincrone.

Requisiti


Client minimo supportato	Windows XP, Windows 2000 Professional con SP3 [solo app desktop]
Server minimo supportato	Windows Server 2003, Windows 2000 Server con SP3 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wuapi.h
Libreria	Wuguid.lib
DLL	Wuapi.dll

Vedi anche

IUpdateInstaller

Condividi tramite