ICatRegister::RegisterCategories method (comcat.h)

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

Syntax

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

Parameters

[in] cCategories

The number of component categories to be registered.

[in] rgCategoryInfo

An array of CATEGORYINFO structures, one for each category to be registered. By providing the same CATID for multiple CATEGORYINFO structures, multiple locales can be registered for the same component category.

Return value

This method can return the following values.

Return code Description
S_OK
The method completed successfully.
E_INVALIDARG
One or more arguments are incorrect.

Remarks

This method 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.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header comcat.h

See also

ICatRegister