ICatInformation::EnumCategories

Returns an enumerator for the component categories registered on the system.

HRESULT EnumCategories(
  LCID lcid,  //Requested locale for returned szDescription of 
              // enumerated CATEGORYINFOs
  IEnumCATEGORYINFO** ppenumCatInfo
              //Location in which to return an IEnumCATEGORYINFO 
              // interface
);
 

Parameters

lcid

[in] Identifies the requested locale for any return szDescription of the enumerated CATEGORYINFOs. Typically, the caller specifies GetUserDefaultLCID for this parameter.

ppenumCatInfo

[out] Specifies the location to return an IEnumCATEGORYINFO interface. This can be used to enumerate the CATIDs and localized description strings of the component categories registered with the system.

Return Values

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.

QuickInfo

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

See Also

ICatInformation::EnumClassesOfCategories, ICatInformation::EnumImplCategoriesOfClass, ICatInformation::EnumReqCategoriesOfClass, ICatInformation::GetCategoryDesc, ICatInformation::IsClassOfCategories