ICatInformation::EnumClassesOfCategories method

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]       IEnumCLSID **ppenumClsid
);

Parameters

cImplemented [in]

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.

rgcatidImpl [in]

An array of category identifiers.

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

cRequired [in]

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.

rgcatidReq [in]

An array of category identifiers.

ppenumClsid [out]

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

ComCat.h

IDL

ComCat.idl

IID

IID_ICatInformation is defined as 0002E013-0000-0000-C000-000000000046

See also

ICatInformation

 

 

Show: