Contents Previous Page Next Page
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                    
                                                                                                                                                   
    REFCLSID rclsid,                                  //The CLSID to be queried                                                                    
                                                                                                                                                   
    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.

rclsid

[in] Specifies the CLSID to be queried. If rclsid is CLSID_NULL, the enumerator returned will enumerate all component categories.

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.

See Also

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