Modello a oggetti dell'agente Windows Update
I programmatori che usano Windows Update Agent (WUA) iniziano aggiungendo un riferimento a Wuapi.dll al progetto corrente (in Visual C++, Microsoft Visual Basic o C#) o facendo riferimento a Wuapi.h e Wuguid.lib in un progetto C o C++. Il primo passaggio nell'uso dell'API WUA consiste nel creare un'istanza di una delle interfacce creando un oggetto dalla coclasse appropriata.
La figura seguente descrive il modello a oggetti WUA. Per altre informazioni, vedere la sezione "Oggetti WUA e attività associate". Per un elenco completo di tutte le interfacce WUA, vedere Interfacce.
Oggetti WUA e attività associate
Nella tabella seguente sono elencati gli oggetti WUA e le attività tipiche associate agli oggetti WUA.
| Oggetto | Descrizione |
|---|---|
| AutomaticUpdates | Iniziare, sospendere o riprendere la Aggiornamenti automatica. |
| AutomaticUpdatesSettings | Recuperare o impostare il giorno e l'ora di installazione degli aggiornamenti. Specificare il modo in cui gli utenti ricevono una notifica di un evento di Aggiornamenti automatico. |
| Category | Recuperare informazioni sulla categoria dell'aggiornamento, inclusi il nome, l'ID, la descrizione, il proprietario e il prodotto desiderato. Recuperare una raccolta di aggiornamenti appartenenti a questa categoria. Recuperare una raccolta delle categorie padre o figlio. |
| CategoryCollection | Accedere a una raccolta di oggetti Category. |
| DownloadResult | Recuperare informazioni sul risultato di un download. |
| InstallationResult | Recuperare informazioni sul risultato di un'installazione o di una disinstallazione. Determinare se è necessario un riavvio del sistema per completare l'installazione o la disinstallazione. |
| Searchresult | Recuperare informazioni sul risultato di una ricerca di categorie o aggiornamenti. Recuperare una raccolta di categorie trovate nel computer di destinazione dalla ricerca. Recuperare una raccolta di aggiornamenti trovati dalla ricerca. |
| SystemInformation | Recuperare informazioni sui requisiti hardware e di riavvio del sistema OEM nel computer di destinazione. |
| Aggiornamento | Recuperare la maggior parte delle informazioni sull'aggiornamento, inclusi gli aggiornamenti in bundle, i requisiti di origine, l'identità, la descrizione, le opzioni di disinstallazione, la priorità di download, le dimensioni e la scadenza. |
| UpdateCollection | Accedere a una raccolta di oggetti Update. |
| UpdateDownloader | Avviare un download asincrono o sincrono dei file associati agli aggiornamenti. |
| UpdateDownloadResult | Recuperare informazioni sul risultato del download per un aggiornamento. |
| Updateexception | Recuperare la descrizione e il contesto di un'eccezione generata quando si verifica un errore di aggiornamento. |
| UpdateExceptionCollection | Accedere a una raccolta di oggetti UpdateException. |
| UpdateHistoryEntry | Recuperare informazioni su un aggiornamento installato o disinstallato, inclusa l'applicazione elaborata, la data e la descrizione. |
| UpdateHistoryEntryCollection | Accedere a una raccolta di oggetti UpdateHistoryEntry. |
| UpdateInstallationResult | Recuperare informazioni sul risultato dell'installazione o della disinstallazione per un aggiornamento. |
| UpdateInstaller | Avviare un'installazione asincrona o sincrona o la disinstallazione di un aggiornamento. Avviare una sequenza di dialogo interattiva per guidare l'utente nei passaggi per installare gli aggiornamenti. |
| UpdateSearcher | Cerca gli aggiornamenti nel server in base a criteri quali il tipo di aggiornamento, l'ID o la categoria. |
| UpdateSession | Avviare una sessione per cercare, scaricare, installare o disinstallare gli aggiornamenti per un'applicazione. |
| Webproxy | Recuperare e impostare le impostazioni proxy HTTP. |