Metodo IUpdateInstaller::BeginUninstall (wuapi.h)

Articolo
08/28/2023

Avvia una disinstallazione asincrona degli aggiornamenti.

Sintassi

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

Parametri

[in] onProgressChanged

Interfaccia IInstallationProgressChangedCallback chiamata periodicamente per le modifiche dello stato di avanzamento della disinstallazione prima del completamento della disinstallazione.

[in] onCompleted

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

[in] state

Stato specifico del chiamante restituito dall'interfaccia IInstallationJob della proprietà AsyncState.

[out] retval

Interfaccia IInstallationJob che contiene le proprietà e i metodi disponibili per un'operazione di disinstallazione 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	Rimozione asincrona di un aggiornamento avviato correttamente.
WU_E_INSTALL_NOT_ALLOWED	Non 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

Requisito	Valore
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