ICatInformation::EnumCategories

This method returns an enumerator for the component categories registered on the system.

HRESULT EnumCategories(
  LCID lcid, 
  IEnumCATEGORYINFO** ppenumCatInfo 
);

Parameters

  • lcid
    [in] Value that identifies the requested locale for any return szDescription of the enumerated CATEGORYINFO structures. Typically, the caller specifies GetUserDefaultLCID for this parameter.
  • ppenumCatInfo
    [out] 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

The following table shows the return values for this method.

Value Description
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.

Remarks

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

OS Versions: Windows CE 3.0 and later.
Header: Comcat.h, Comcat.idl.
Link Library: Ole32.lib, Uuid.lib.

See Also

ICatInformation::EnumClassesOfCategories | ICatInformation::EnumImplCategoriesOfClass | ICatInformation::EnumReqCategoriesOfClass | ICatInformation::GetCategoryDesc | ICatInformation::IsClassOfCategories

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.