Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method removes one or more implemented category identifiers from a class.

Syntax 

HRESULT UnRegisterClassImplCategories(
  REFCLSID 
rclsid, 
  ULONG 
cCategories, 
  CATID 
rgcatid[] 
);

Parameters

rclsid

[in] Class identifier of the relevant class to be manipulated.

cCategories

[in] Number of category CATIDs to remove.

rgcatid

[in] Array of cCategoriesCATID that are to be removed. Only the category identifiers specified in this array are 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

In case of an error, this function does not ensure that the Registry is restored to the state prior to the call.

The call will be successful even if one or more of the category identifiers specified are not registered for the class.

This function can only be called by the owner of a class, usually as part of the de-installation of the component.

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