ICatRegister::UnRegisterClassReqCategories

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

HRESULT UnRegisterClassReqCategories(
  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 cCategories CATID that are to be removed. Only the category identifiers specified in this array are removed.

Return Values

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.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Comcat.h, Comcat.idl.
Link Library: Ole32.lib, Uuid.lib.

See Also

ICatRegister::RegisterCategories | ICatRegister::RegisterClassImplCategories | ICatRegister::UnRegisterCategories | ICatRegister::UnRegisterClassImplCategories | ICatRegister::RegisterClassReqCategories

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.