Share via

ICatRegister::UnRegisterCategories (Windows Embedded CE 6.0)

  • Article

1/6/2010

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.

Syntax

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 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 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

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

See Also

Reference

ICatRegister
ICatRegister::RegisterCategories
ICatRegister::RegisterClassImplCategories
ICatRegister::RegisterClassReqCategories
ICatRegister::UnRegisterClassImplCategories
ICatRegister::UnRegisterClassReqCategories