Windows Update-Agent-Objektmodell

Programmierer, die den Windows Update-Agent (WUA) verwenden, beginnen mit dem Hinzufügen eines Verweises auf Wuapi.dll zu ihrem aktuellen Projekt (in Visual C++, Microsoft Visual Basic oder C#) oder durch Verweisen auf Wuapi.h und Wuguid.lib in einem C- oder C++-Projekt. Der erste Schritt bei der Verwendung der WUA-API besteht darin, eine Instanz einer der Schnittstellen durch Erstellen eines Objekts aus der entsprechenden Coclass zu erstellen.

In der folgenden Abbildung wird das WUA-Objektmodell beschrieben. Weitere Informationen finden Sie im Abschnitt "WUA Objects and Associated Tasks". Eine vollständige Liste aller WUA-Schnittstellen finden Sie unter Schnittstellen.

WUA-Objekte und zugeordnete Aufgaben

In der folgenden Tabelle sind die WUA-Objekte und die typischen Aufgaben aufgeführt, die den WUA-Objekten zugeordnet sind.

Objekt	Beschreibung
AutomaticUpdates-	Starten, Anhalten oder Fortsetzen automatischer Updates.
AutomaticUpdatesSettings-	Rufen Sie den Tag und die Uhrzeit der Installation von Updates ab, oder legen Sie sie fest. Geben Sie an, wie Benutzer über ein Ereignis für automatische Updates benachrichtigt werden.
Kategorie-	Rufen Sie Informationen zur Kategorie des Updates ab, einschließlich Name, ID, Beschreibung, Besitzer und beabsichtigtes Produkt. Dient zum Abrufen einer Sammlung von Updates, die zu dieser Kategorie gehören. Dient zum Abrufen einer Auflistung der übergeordneten oder untergeordneten Kategorien.
CategoryCollection-	Greifen Sie auf eine Auflistung von Category-Objekten zu.
DownloadResult-	Rufen Sie Informationen zum Ergebnis eines Downloads ab.
InstallationResult-	Abrufen von Informationen zum Ergebnis einer Installation oder Deinstallation. Ermitteln Sie, ob ein Systemneustart erforderlich ist, um die Installation oder Deinstallation abzuschließen.
SearchResult-	Rufen Sie Informationen zum Ergebnis einer Suche nach Kategorien oder Updates ab. Dient zum Abrufen einer Sammlung von Kategorien, die auf dem Zielcomputer durch die Suche gefunden werden. Dient zum Abrufen einer Sammlung von Updates, die von der Suche gefunden wurden.
SystemInformation-	Abrufen von Informationen zu OEM-Hardware- und Systemneustartanforderungen auf dem Zielcomputer.
Update-	Rufen Sie die meisten Informationen zum Update ab, einschließlich gebündelter Updates, Quellanforderungen, Identität, Beschreibung, Deinstallationsoptionen, Downloadpriorität, Größe und Stichtag.
UpdateCollection-	Greifen Sie auf eine Auflistung von Update-Objekten zu.
UpdateDownloader-	Starten Sie einen asynchronen oder synchronen Download der Dateien, die den Updates zugeordnet sind.
UpdateDownloadResult-	Rufen Sie Informationen zum Ergebnis des Downloads für ein Update ab.
UpdateException-	Rufen Sie die Beschreibung und den Kontext einer Ausnahme ab, die ausgelöst wird, wenn ein Updatefehler auftritt.
UpdateExceptionCollection-	Greifen Sie auf eine Auflistung von UpdateException-Objekten zu.
UpdateHistoryEntry-	Rufen Sie Informationen zu einem Update ab, das installiert oder deinstalliert wurde, einschließlich der verarbeiteten Anwendung, des Datums und der Beschreibung.
UpdateHistoryEntryCollection-	Greifen Sie auf eine Auflistung von UpdateHistoryEntry-Objekten zu.
UpdateInstallationResult-	Rufen Sie Informationen zum Ergebnis der Installation oder Deinstallation für ein Update ab.
UpdateInstaller-	Starten Sie eine asynchrone oder synchrone Installation oder Deinstallation eines Updates. Starten Sie eine interaktive Dialogsequenz, um den Benutzer durch die Schritte zum Installieren von Updates zu führen.
UpdateSearcher-	Sucht nach Updates auf dem Server anhand von Kriterien wie dem Updatetyp, der ID oder der Kategorie.
UpdateSession-	Starten Sie eine Sitzung, um die Updates für eine Anwendung zu suchen, herunterzuladen, zu installieren oder zu deinstallieren.
WebProxy-	Abrufen und Festlegen von HTTP-Proxyeinstellungen.