Επεξεργασία

Κοινή χρήση μέσω

ICategorizer::GetCategory method (shobjidl_core.h)

  • Άρθρο

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

[in] cidl

Type: UINT

The number of items in an item identifier list array.

[in] apidl

Type: PCUITEMID_CHILD_ARRAY*

A pointer to an array of cidl item identifier list pointers.

[out] rgCategoryIds

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

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shobjidl.h)
DLL Shell32.dll