ICatRegister::UnRegisterCategories method (comcat.h)

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(
  [in] ULONG    cCategories,
  [in] CATID [] rgcatid
);

Parameters

[in] cCategories

The number of categories to be removed.

[in] rgcatid

The CATIDs of the categories to be removed.

Return value

This method can return the following values.

Return code	Description
S_OK	The method completed successfully.
E_INVALIDARG	One or more arguments are incorrect.

Remarks

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

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

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	comcat.h

See also

ICatRegister