Export (0) Print
Expand All

IUpdate::Categories property

Gets an interface that contains a collection of categories to which the update belongs.

This property is read-only.

Syntax


HRESULT get_Categories(
  [out]  ICategoryCollection **retval
);

Property value

An ICategoryCollection interface that contains a collection of categories to which the update belongs.

Error codes

Returns S_OK if successful. Otherwise, returns a COM or Windows error code.

Remarks

If the IUpdateSearcher interface is created by using the IUpdateSession::CreateUpdateSearcher method, the information that this property returns is for the language that is specified by the UserLocale property of the IUpdateSession2 interface of the session that was used to create IUpdateSearcher.

If a language preference is not specified by the UserLocale property of IUpdateSession2, or if the IUpdateSearcher interface is not created by using IUpdateSession::CreateUpdateSearcher, the information that this property returns is for the default user interface (UI) language of the user. If the default UI language of the user is unavailable, Windows Update Agent (WUA) uses the default UI language of the computer. If the default language of the computer is unavailable, WUA uses the language that the provider of the update recommends.

Because there is a Categories property of IUpdate and a Categories property of IUpdateHistoryEntry2, the information that is used by the localized properties of the ICategory interface depend on the WUA object that owns the ICategory interface. If the ICategory interface is returned from the Categories property of IUpdate, it follows the localization rules of IUpdate. If the ICategory interface is returned from the Categories property of IUpdateHistoryEntry2, it follows the localization rules of IUpdateHistoryEntry2.

Requirements

Minimum supported client

Windows XP, Windows 2000 Professional with SP3 [desktop apps only]

Minimum supported server

Windows Server 2003, Windows 2000 Server with SP3 [desktop apps only]

Header

Wuapi.h

IDL

Wuapi.idl

Library

Wuguid.lib

DLL

Wuapi.dll

See also

IUpdate

 

 

Community Additions

ADD
Show:
© 2014 Microsoft