IUpdate::get_Categories-Methode (wuapi.h)

Ruft eine Schnittstelle ab, die eine Auflistung von Kategorien enthält, zu denen das Update gehört.

Diese Eigenschaft ist schreibgeschützt.

Syntax

HRESULT get_Categories(
  ICategoryCollection **retval
);

Parameter

retval

Rückgabewert

Keine

Bemerkungen

Wenn die IUpdateSearcher-Schnittstelle mithilfe der IUpdateSession::CreateUpdateSearcher-Methode erstellt wird, sind die von dieser Eigenschaft zurückgegebenen Informationen für die Sprache bestimmt, die von der UserLocale-Eigenschaft der IUpdateSession2-Schnittstelle der Sitzung angegeben wird, die zum Erstellen von IUpdateSearcher verwendet wurde.

Wenn keine Spracheinstellung durch die UserLocale-Eigenschaft von IUpdateSession2 angegeben wird oder wenn die IUpdateSearcher-Schnittstelle nicht mithilfe von IUpdateSession::CreateUpdateSearcher erstellt wird, sind die von dieser Eigenschaft zurückgegebenen Informationen für die Standardsprache der Benutzeroberfläche (UI) des Benutzers bestimmt. Wenn die Standardsprache der Benutzeroberfläche des Benutzers nicht verfügbar ist, verwendet Windows Update-Agent (WUA) die Standardsprache der Benutzeroberfläche des Computers. Wenn die Standardsprache des Computers nicht verfügbar ist, verwendet WUA die Sprache, die der Anbieter des Updates empfiehlt.

Da es eine Categories-Eigenschaft von IUpdate und eine Categories-Eigenschaft von IUpdateHistoryEntry2 gibt, hängen die Informationen, die von den lokalisierten Eigenschaften der ICategory-Schnittstelle verwendet werden, vom WUA-Objekt ab, das die ICategory-Schnittstelle besitzt. Wenn die ICategory-Schnittstelle von der Categories-Eigenschaft von IUpdate zurückgegeben wird, folgt sie den Lokalisierungsregeln von IUpdate. Wenn die ICategory-Schnittstelle von der Categories-Eigenschaft von IUpdateHistoryEntry2 zurückgegeben wird, folgt sie den Lokalisierungsregeln von IUpdateHistoryEntry2.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wuapi.h
Bibliothek	Wuguid.lib
DLL	Wuapi.dll

Weitere Informationen

IUpdate