SHCOLUMNDATA 結構 (shlobj.h)

包含識別特定檔案的資訊。 當要求特定檔案的數據時， 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 字串。

規格需求

另請參閱

GetFileAttributes