ICatRegister::UnRegisterCategories
A version of this page is also available for
4/8/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 |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
ICatRegister::RegisterCategories
ICatRegister::RegisterClassImplCategories
ICatRegister::RegisterClassReqCategories
ICatRegister::UnRegisterClassImplCategories
ICatRegister::UnRegisterClassReqCategories