ICatRegister::UnRegisterCategories

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,  //Number of cCategories CATIDs to be removed
  REFCATID rgcatid    //Array of cCategories CATIDs
);

Parameters

cCategories: [in] The number of cCategories CATIDs to be removed.
rgcatid: [in] Identifies the categories to be removed.

Return Values

S_OK: The function was successful.
E_INVALIDARG: One or more arguments are incorrect.

Remarks

This function will be successful even if one or more of the category IDs 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::UnRegisterClassCategories method.

QuickInfo

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