ICatRegister::RegisterClassReqCategories

This method registers the class as requiring one or more component categories.

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

Parameters

  • rclsid
    [in] Class identifier of the relevant class for which category information will be set.
  • cCategories
    [in] Number of category CATIDs to associate as category identifiers for the class.
  • rgcatid
    [in] Array of cCategories CATID to associate as category identifiers for the class.

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. This function can only be called by the owner of a class, usually as part of the installation of the component.

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::UnRegisterClassReqCategories

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.