Edit

Share via

ICatInformation::EnumClassesOfCategories method (comcat.h)

  • Article

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

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header comcat.h

See also

ICatInformation