IShellFolder2：：GetDefaultColumn 方法 (shobjidl_core.h)

获取默认排序和显示列。

语法

HRESULT GetDefaultColumn(
  [in]  DWORD dwRes,
  [out] ULONG *pSort,
  [out] ULONG *pDisplay
);

参数

[in] dwRes

类型：DWORD

保留。 设置为零。

[out] pSort

类型： ULONG*

指向接收默认排序列的索引的值的指针。

[out] pDisplay

类型： ULONG*

指向接收默认显示列索引的值的指针。

返回值

类型： HRESULT

如果成功，则返回S_OK，否则返回 COM 错误值。

注解

用户备注

此方法返回的两个列索引都供显示此文件夹的文件夹视图的应用程序使用。

pSort 指定的列是应该用于对文件夹中的项目进行排序的列。 若要确定任意一对项的排序顺序，请将其 PIDL 传递给 CompareIDs。 通过将 CompareIDs 的 lParam 参数设置为 pSort 指向的值来指定列。

如果视图仅显示一个字符串来表示项，则应从 pDisplay 指定的列中获取它。 将列索引和项的 PIDL 传递给 IShellFolder2：：GetDetailsOf 以检索字符串。

实施者说明

此方法是命名空间扩展的文件夹对象实现的一部分。 它通常由文件夹视图对象调用，以询问文件夹对象应使用 Microsoft Windows 资源管理器详细信息视图中的哪一列对文件夹中的项目进行排序。 例如，表示事务日志的文件夹对象可能会将 pSort 设置为显示事务时间的列。 然后，这些项将按事务发生的时间排序，而不是按名称排序。

某些客户端可能会调用此方法来请求列的索引，该列的名称应显示在树视图中。 将 pDisplay 设置为相应的列索引。 然后，客户端将通过调用 IShellFolder2：：GetDetailsOf 获取显示名称。

要求

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