Share via

ICatRegister::UnRegisterCategories

  • Article

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

HRESULT UnRegisterCategories(
  ULONG cCategories, 
  CATID rgcatid[] 
);

Parameters

  • cCategories
    [in] Number of cCategories CATIDs to be removed.
  • rgcatid
    [in] Value that identifies the categories to be removed.

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 will be successful even if one or more of the category identifiers specified are not registered. 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.

**Note   **This method does not remove the component category tags from individual classes. To do this, use the ICatRegister::UnRegisterClassReqCategories method.

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::RegisterCategories | ICatRegister::RegisterClassImplCategories | ICatRegister::RegisterClassReqCategories | ICatRegister::UnRegisterClassImplCategories | ICatRegister::UnRegisterClassReqCategories

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.