Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method registers one or more component categories. Each component category consists of a CATID and a list of locale-dependent description strings.

Syntax

HRESULT RegisterCategories(
  ULONG 
cCategories, 
  CATEGORYINFO 
rgCategoryInfo[] 
);

Parameters

cCategories

[in] Number of component categories to register.

rgCategoryInfo

[in] Array of cCategories CATEGORYINFOstructures.

By providing the same CATID for multiple CATEGORYINFOstructures, multiple locales can be registered for the same component category.

Return Value

If the method succeeds, the return value is S_OK.

If one or more arguments are incorrect, the method returns E_INVALIDARG.

Remarks

This function can only be called by the owner of a category, usually as part of the installation or de-installation of the operating system or application.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

Header comcat.h, comcat.idl
Library ole32.lib, uuid.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also