Поделиться через


Структура 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, с расширением имени файла.

wszFile[MAX_PATH]

Тип: WCHAR[MAX_PATH]

Строка Юникода, завершающаяся null, содержащая полный путь к файлу.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional, Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Верхняя часть shlobj.h

См. также раздел

GetFileAttributes