ICatInformation::EnumClassesOfCategories (Compact 2013)

  • Article

3/26/2014

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.

Syntax

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 Value

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

Header

comcat.h,
comcat.idl

Library

ole32.lib,
uuid.lib

See Also

Reference

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