shlobj.h) (SHCOLUMNDATA 结构

项目
08/26/2023

包含标识特定文件的信息。请求特定文件的数据时， IColumnProvider：：GetItemData 使用它。

语法

typedef struct {
  ULONG dwFlags;
  DWORD dwFileAttributes;
  ULONG dwReserved;
  WCHAR *pwszExt;
  WCHAR wszFile[MAX_PATH];
} SHCOLUMNDATA, *LPSHCOLUMNDATA;

成员

dwFlags

类型： ULONG

用于指定请求性质的标志。

SHCDF_UPDATEITEM

wszFile 指定的文件是一个新文件或自上次调用 IColumnProvider：：GetItemData 以来已更改的文件。应刷新并重新计算任何缓存的数据。不缓存数据或显示独立于文件存储的数据的列处理程序可以忽略此标志。

dwFileAttributes

类型：DWORD

文件属性标志。它将是以下一个或多个值。

FILE_ATTRIBUTE_ARCHIVE

文件或目录是存档文件或目录。应用程序使用此属性来标记要备份或删除的文件。

FILE_ATTRIBUTE_COMPRESSED

文件或目录已压缩。对于文件，这意味着文件中的所有数据都已压缩。对于目录，这意味着压缩是新创建文件和子目录的默认设置。

FILE_ATTRIBUTE_DIRECTORY

句柄标识目录。

FILE_ATTRIBUTE_ENCRYPTED

此文件或目录已加密。对于文件，这意味着文件中的所有数据流都已加密。对于目录，这意味着加密是新创建的文件和子目录的默认设置。

FILE_ATTRIBUTE_HIDDEN

文件或目录已隐藏。文件不会包括在普通的目录列表中。

FILE_ATTRIBUTE_NORMAL

文件或目录没有其他属性集。此属性仅在单独使用时有效。

FILE_ATTRIBUTE_OFFLINE

文件数据不能立即供使用。此属性指示文件数据已物理移动到脱机存储。远程存储（Windows 2000 中的分层存储管理软件）使用此属性。如果设置了此属性，列处理程序应避免打开文件，因为这样做将导致文件从脱机存储中被召回。

FILE_ATTRIBUTE_READONLY

文件或目录为只读。应用程序可以读取该文件，但无法写入或删除该文件。对于目录，应用程序无法将其删除。

FILE_ATTRIBUTE_REPARSE_POINT

该文件具有关联的重新分析点。

FILE_ATTRIBUTE_SPARSE_FILE

此文件是稀疏文件。

FILE_ATTRIBUTE_SYSTEM

文件或目录是操作系统的一部分，或者由操作系统独占使用。

FILE_ATTRIBUTE_TEMPORARY

该文件用于临时存储。文件系统尝试将所有数据保存在内存中，而不是将数据刷新回大容量存储，以便可以快速访问。当临时文件不再需要时，应用程序应立即删除它。

dwReserved

类型： ULONG

保留。设置为 NULL。

pwszExt

类型： WCHAR*

指向文件扩展名为 null 的 Unicode 字符串的指针。

wszFile[MAX_PATH]

类型： WCHAR[MAX_PATH]

包含完全限定文件路径的以 null 结尾的 Unicode 字符串。

要求

要求	值
最低受支持的客户端	Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
标头	shlobj.h

另请参阅

GetFileAttributes

通过