ICatInformation::EnumCategories (Compact 2013)

  • Article

3/26/2014

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

Syntax

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 Value

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

Header

comcat.h,
comcat.idl

Library

ole32.lib,
uuid.lib

See Also

Reference

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