ICategoryProvider：：GetDefaultCategory 方法 (shobjidl_core.h)

  • 项目

使文件夹能够替代默认分组。

语法

HRESULT GetDefaultCategory(
  [out] GUID       *pguid,
  [out] SHCOLUMNID *pscid
);

参数

[out] pguid

类型： GUID*

未使用。

[out] pscid

类型： SHCOLUMNID*

此方法返回时，包含指向 SHCOLUMNID 结构的指针。

返回值

类型： HRESULT

如果成功，则返回S_OK，否则返回错误值，包括以下内容：

返回代码 说明
S_FALSE
 没有默认组。

注解

ICategoryProvider：：GetDefaultCategory 返回默认分类程序使用的 SHCOLUMNID 结构。 如果不支持默认组，该方法将返回S_FALSE。

ICategoryProvider：：GetDefaultCategory 仅在首次打开文件夹时调用。 之后，用户的分组选项将缓存在存储视图状态 的属性包 中。 若要在首次打开文件夹后强制调用 ICategoryProvider：：GetDefaultCategory ，必须删除 Shell 和 ShellNoRoam 注册表项。 它们位于以下位置。

HKEY_CURRENT_USER
   Software
      Microsoft
         Windows
            Shell
            ShellNoRoam

要求

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