Share via

ICatInformation::EnumClassesOfCategories

  • Article

This method returns an enumerator over the classes that implement one or more of the rgcatidImpl parameter. If a class requires a category not listed in the rgcatidReq parameter, it is not included in the enumeration.

HRESULT EnumClassesOfCategories(
  ULONG cImplemented, 
  CATID rgcatidImpl, 
  ULONG cRequired, 
  CATID rgcatidReq, 
  IEnumCLSID** ppenumCLSID
);

Parameters

  • cImplemented
    [in] Number of category identifiers in the rgcatidImpl array. This value cannot be zero. If this value is ((ULONG) -1), classes are included in the enumeration, regardless of the categories they implement.
  • rgcatidImpl
    [in] Array of category identifiers.
  • cRequired
    [in] Number of category identifiers in the rgcatidReq array. This value can be zero. If this value is ((ULONG) -1), classes are included in the enumeration, regardless of the categories they require.
  • rgcatidReq
    [in] Array of category identifiers.
  • ppenumCLSID
    [out] The location in which to return an IEnumCLSID interface that can be used to enumerate the CLSIDs of the classes that implement category rcatid.

Return Values

The following table shows the return values for this method.

Value Description
S_OK The function was successful.
E_INVALIDARG One or more arguments are incorrect.
E_OUTOFMEMORY Insufficient memory to create and return an enumerator object.

Remarks

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

ICatInformation::EnumCategories | ICatInformation::EnumImplCategoriesOfClass | ICatInformation::EnumReqCategoriesOfClass | ICatInformation::GetCategoryDesc | ICatInformation::IsClassOfCategories

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.