ICatRegister::UnRegisterCategories (Compact 2013)

  • Article

3/26/2014

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

See Also

Reference

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