ICatRegister::RegisterCategories

  • Article

This method 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, 
  CATEGORYINFO rgCategoryInfo[] 
);

Parameters

  • cCategories
    [in] Number of component categories to register.
  • rgCategoryInfo
    [in] Array of cCategoriesCATEGORYINFO structures. By providing the same CATID for multiple CATEGORYINFO structures, multiple locales can be registered for the same component category.

Return Values

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

OS Versions: Windows CE 3.0 and later.
Header: Comcat.h, Comcat.idl.
Link Library: Ole32.lib, Uuid.lib.

See Also

ICatRegister::RegisterClassImplCategories | ICatRegister::RegisterClassReqCategories | ICatRegister::UnRegisterCategories | ICatRegister::UnRegisterClassImplCategories | ICatRegister::UnRegisterClassReqCategories

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.