ICategory::get_Name-Methode (wuapi.h)
Ruft den lokalisierten Namen der Kategorie ab.
Diese Eigenschaft ist schreibgeschützt.
Syntax
HRESULT get_Name(
BSTR *retval
);
Parameter
retval
Rückgabewert
Keine
Bemerkungen
Für die IUpdate-Schnittstelle ist eine Categories-Eigenschaft vorhanden. Außerdem ist eine Categories-Eigenschaft für die IUpdateHistoryEntry2-Schnittstelle vorhanden. Daher hängen die Informationen, die von den lokalisierten Eigenschaften der ICategory-Schnittstelle verwendet werden, vom wua-Objekt (Windows Update Agent) ab, das die ICategory-Schnittstelle besitzt.
Wenn die ICategory-Schnittstelle von der Categories-Eigenschaft von IUpdate zurückgegeben wird, folgt die ICategory-Schnittstelle den Lokalisierungsregeln der IUpdate-Schnittstelle . Wenn die IUpdateSearcher-Schnittstelle in diesem Fall 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 wird.
Wenn von der UserLocale-Eigenschaft der IUpdateSession2-Schnittstelle keine Spracheinstellung angegeben wird oder wenn die IUpdateSearcher-Schnittstelle nicht mit der IUpdateSession::CreateUpdateSearcher-Methode 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 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.
Wenn die ICategory-Schnittstelle von der Categories-Eigenschaft der IUpdateHistoryEntry2-Schnittstelle zurückgegeben wird, folgt die ICategory-Schnittstelle den Lokalisierungsregeln der IUpdateHistoryEntry2-Schnittstelle . Die von dieser Eigenschaft zurückgegebenen Informationen sind für die Standardsprache der Benutzeroberfläche des Benutzers. Wenn die Standardsprache der Benutzeroberfläche des Benutzers nicht verfügbar ist, verwendet 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.
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 |