ICategorizer::GetCategory method
Gets a list of categories associated with a list of identifiers.
Syntax
HRESULT GetCategory( [in] UINT cidl, [in] PCUITEMID_CHILD_ARRAY *apidl, [out] DWORD *rgCategoryIds );
Parameters
- cidl [in]
-
Type: UINT
The number of items in an item identifier list array.
- apidl [in]
-
Type: PCUITEMID_CHILD_ARRAY*
A pointer to an array of cidl item identifier list pointers.
- rgCategoryIds [out]
-
Type: DWORD*
When this method returns, contains a pointer to an array of cidl category identifiers.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
The ICategorizer::GetCategory method accepts an array of pointers to item identifier lists (PIDLs) and fills an array of category identifiers.
Important The value -1 is an invalid category identifier.
Requirements
|
Minimum supported client |
Windows XP [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 [desktop apps only] |
|
Header |
|
|
IDL |
|
|
DLL |
|
Show: