ICategorizer::GetCategory 方法 (shobjidl_core.h)

获取与标识符列表关联的类别列表。

语法

HRESULT GetCategory(
  [in]  UINT                  cidl,
  [in]  PCUITEMID_CHILD_ARRAY apidl,
  [out] DWORD                 *rgCategoryIds
);

参数

[in] cidl

类型: UINT

项标识符列表数组中的项数。

[in] apidl

类型: PCUITEMID_CHILD_ARRAY*

指向 cidl 项标识符列表指针数组的指针。

[out] rgCategoryIds

类型: DWORD*

此方法返回时,包含指向 cidl 类别标识符数组的指针。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

ICategorizer::GetCategory 方法接受指向项标识符列表的指针数组, (PIDL) 并填充类别标识符数组。

重要 值 -1 是无效的类别标识符。
 

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 shobjidl_core.h (包括 Shobjidl.h)
DLL Shell32.dll