IShellDetails：：GetDetailsOf 方法 (shlobj_core.h)

获取有关 Shell 文件夹中的项的详细信息。

语法

HRESULT GetDetailsOf(
  [in, optional] PCUITEMID_CHILD pidl,
                 UINT            iColumn,
  [out]          SHELLDETAILS    *pDetails
);

参数

[in, optional] pidl

类型： PCUITEMID_CHILD

要请求其信息的项的 PIDL。 如果此参数设置为 NULL，则 pDetails 指向的 SHELLDETAILS 结构中将返回 iColumn 指定的信息字段的标题。

iColumn

类型： UINT

所需信息字段的从零开始的索引。 它与信息列号相同，因为它显示在 Windows 资源管理器详细信息视图中。

[out] pDetails

类型： SHELLDETAILS*

指向包含详细信息的 SHELLDETAILS 结构的指针。

返回值

类型： HRESULT

如果成功，则返回S_OK。 如果 iColumn 超过文件夹支持的列数，则返回E_FAIL。 否则， 将返回标准 COM 错误代码。

注解

此方法已被 Shell 版本 5.0 及更高版本的 IShellFolder2 方法取代。

IShellDetails：：GetDetailsOf 方法提供对 Shell 文件夹的 Windows 资源管理器详细信息视图中显示的信息的访问权限。 在“详细信息”视图中看到的列号、列标题和项信息与 IShellDetails：：GetDetailsOf 返回的列号、列标题和项信息相同。

可用信息字段及其列号因特定文件夹而异。 若要枚举可用字段，请调用 IShellDetails：：GetDetailsOf ，并将 pidl 设置为 NULL 以增加 iColumn 的值。 此方法提供与每个列索引关联的标题。 当 iColumn 超过文件夹支持的列数时， IShellDetails：：GetDetailsOf 将返回E_FAIL。 请记住，这些标题是可本地化的，并且可能不是所有区域设置的相同。

文件系统文件夹具有大量的标准信息字段。 前四个字段是所有文件系统文件夹的标准字段。

列索引	列标题
0	名称
1	大小
2	类型
3	修改日期

 

文件系统文件夹可能支持多个附加字段。 但是，它们不需要这样做，分配给这些字段的列索引可能会有所不同。

每个虚拟文件夹都有其自己唯一的信息字段集。 通常，项的显示名称位于第 0 列中，但可用字段的顺序和内容取决于特定文件夹对象的实现。

实现者注意事项

Folder 对象应实现 IShellFolder2 而不是此接口。

要求

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