ICatInformation::IsClassOfCategories

Determines if a class implements one or more categories. If the class requires a category not listed in rgcatidReq, it is not included in the enumeration.

HRESULT IsClassOfCategories(
  REFCLSID rclsid,    //Class ID of the class to query
  ULONG cImplemented, //Number of category IDs in the rgcatidImpl 
                      // array
  CATID rgcatidImpl,  //Array of category identifiers
  ULONG cRequired,    //Number of category IDs in the rgcatidReq 
                      // array
  CATID rgcatidReq    //Array of category identifiers
);
 

Parameters

rclsid

[in] The class ID of the relevent class to query.

cImplemented

[in] The number of category IDs in the rgcatidImpl array. This value cannot be zero. If this value is ((ULONG) -1), the implemented categories are not tested.

rgcatidImpl

[in] An array of category identifiers.

cRequired

[in] The number of category IDs in the rgcatidReq array. This value can be zero. If this value is ((ULONG) -1), the required categories are not tested.

rgcatidReq

[in] An array of category identifiers.

Return Values

S_OK

rclsid is of category rcatid.

S_FALSE

rclsid is not of category rcatid.

QuickInfo

  Windows NT: Use version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in comcat.h.

See Also

ICatInformation::EnumCategories, ICatInformation::EnumClassesOfCategories, ICatInformation::EnumImplCategoriesOfClass, ICatInformation::EnumReqCategoriesOfClass, ICatInformation::GetCategoryDesc