ICatRegister::RegisterCategories

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

HRESULT RegisterCategories(
  ULONG cCategories,            //Number of component categories
  CATEGORYINFO* rgCategoryInfo  //Array of cCategories CATEGORYINFO 
                                // structures
);
 

Parameters

cCategories

[in] The number of component categories to register.

rgCategoryInfo

[in] The array of cCategories CATEGORYINFO structures. By providing the same CATID for multiple CATEGORYINFO structures, multiple locales can be registered for the same component category.

Return Values

S_OK

The function was successful.

E_INVALIDARG

One or more arguments are incorrect.

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.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in comcat.h.

See Also

ICatRegister::RegisterClassImplCategories, ICatRegister::RegisterClassReqCategories, ICatRegister::UnRegisterCategories, ICatRegister::UnRegisterClassImplCategories, ICatRegister::UnRegisterClassReqCategories