ICatInformation::EnumClassesOfCategories method (comcat.h)

Retrieves an enumerator for the classes that implement one or more specified category identifiers.

Syntax

HRESULT EnumClassesOfCategories(
  [in]  ULONG          cImplemented,
  [in]  const CATID [] rgcatidImpl,
  [in]  ULONG          cRequired,
  [in]  const CATID [] rgcatidReq,
  [out] IEnumGUID      **ppenumClsid
);

Parameters

[in] cImplemented

The number of category IDs in the rgcatidImpl array. This value cannot be zero. If this value is -1, classes are included in the enumeration, regardless of the categories they implement.

[in] rgcatidImpl

An array of category identifiers.

If a class requires a category identifier that is not specified, it is not included in the enumeration.

[in] cRequired

The number of category IDs in the rgcatidReq array. This value can be zero. If this value is -1, classes are included in the enumeration, regardless of the categories they require.

[in] rgcatidReq

An array of category identifiers.

[out] ppenumClsid

A pointer to an IEnumCLSID interface pointer that can be used to enumerate the CLSIDs of the classes that implement the specified category.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, and S_OK.

Requirements

See also

ICatInformation