Share via

Перечисление GETPROPERTYSTOREFLAGS (propsys.h)

  • Статья

Указывает флаги, которые изменяют объект хранилища свойств, полученный методами, создающими хранилище свойств, например IShellItem2::GetPropertyStore или IPropertyStoreFactory::GetPropertyStore.

Синтаксис

typedef enum GETPROPERTYSTOREFLAGS {
  GPS_DEFAULT = 0,
  GPS_HANDLERPROPERTIESONLY = 0x1,
  GPS_READWRITE = 0x2,
  GPS_TEMPORARY = 0x4,
  GPS_FASTPROPERTIESONLY = 0x8,
  GPS_OPENSLOWITEM = 0x10,
  GPS_DELAYCREATION = 0x20,
  GPS_BESTEFFORT = 0x40,
  GPS_NO_OPLOCK = 0x80,
  GPS_PREFERQUERYPROPERTIES = 0x100,
  GPS_EXTRINSICPROPERTIES = 0x200,
  GPS_EXTRINSICPROPERTIESONLY = 0x400,
  GPS_VOLATILEPROPERTIES = 0x800,
  GPS_VOLATILEPROPERTIESONLY = 0x1000,
  GPS_MASK_VALID = 0x1fff
} ;

Константы

 
GPS_DEFAULT
Значение: 0
Значение вызывающего процесса. Возвращает хранилище свойств только для чтения, содержащее все свойства. Медленные элементы (автономные файлы) не открываются.



Сочетание с другими флагами: может быть переопределено другими флагами.
GPS_HANDLERPROPERTIESONLY
Значение: 0x1
Значение для вызывающего процесса. Включите только свойства непосредственно из обработчика свойств, который открывает файл на диске, в сети или на устройстве.



Значение для папки файлов. Включайте только свойства непосредственно из обработчика.

Значение для других папок. При делегировании папке файлов передайте этот флаг в папку файлов; не выполнять мультиплексирование (MUX). Если не делегировать папке файлов, игнорируйте этот флаг, а не возвращайте код сбоя.

Сочетание с другими флагами: не может быть объединено с GPS_TEMPORARY, GPS_FASTPROPERTIESONLY или GPS_BESTEFFORT.
GPS_READWRITE
Значение: 0x2
Значение вызывающего процесса: может записывать свойства в элемент. Примечание. Хранилище может содержать меньше свойств, чем хранилище, доступное только для чтения.



Значение для папки файлов: ReadWrite.

Значение для других папок: ReadWrite. Примечание. При использовании mux по умолчанию возвращается одно неописуемое хранилище, так как mux по умолчанию не поддерживает ReadWrite.

Сочетание с другими флагами: не может быть объединено с GPS_TEMPORARY, GPS_FASTPROPERTIESONLY, GPS_BESTEFFORT или GPS_DELAYCREATION. Подразумевает GPS_HANDLERPROPERTIESONLY.
GPS_TEMPORARY
Значение: 0x4
Значение для вызывающего процесса. Предоставляет хранилище для записи без начальных свойств, которое существует в течение времени существования экземпляра элемента оболочки; В основном это контейнер свойств, присоединенный к экземпляру элемента.



Значение для папки файлов: неприменимо. Обрабатывается элементом оболочки.

Значение для других папок: неприменимо. Обрабатывается элементом оболочки.

Сочетание с другими флагами: не может быть объединено с другими флагами. Подразумевает GPS_READWRITE.
GPS_FASTPROPERTIESONLY
Значение: 0x8
Значение для вызывающего процесса. Предоставляет хранилище, не требующее чтения с диска или сети. Примечание. Некоторые значения могут отличаться или отсутствовать по сравнению с хранилищем без этого флага.



Значение для папки файлов. Включите только "врожденное" и "резервное" хранилища. Не загружайте обработчик.

Значение для других папок. Включите только те свойства, которые доступны в памяти или могут быть вычислены очень быстро (без свойств с дисков, сетевых или периферийных устройств ввода-вывода). Обычно это только источники данных из IDLIST. При делегировании другим папкам передайте им этот флаг.

Сочетание с другими флагами: не может быть объединено с GPS_TEMPORARY, GPS_READWRITE, GPS_HANDLERPROPERTIESONLY или GPS_DELAYCREATION.
GPS_OPENSLOWITEM
Значение: 0x10
Значение вызывающего процесса. При необходимости откройте медленный элемент (автономный файл).



Значение папки файлов. При необходимости извлеките файл из автономного хранилища. Примечание. Без этого флага обработчик не создается для автономных файлов.

Значение для других папок: не возвращайте свойства, которые выполняются очень медленно.

Сочетание с другими флагами: не может быть объединено с GPS_TEMPORARY или GPS_FASTPROPERTIESONLY.
GPS_DELAYCREATION
Значение: 0x20
Значение вызывающего процесса. Отложите операции с большим объемом памяти, такие как доступ к файлам, пока не будет запрошено свойство, требующее такого доступа.



Значение папки файлов: не создавайте обработчик до тех пор, пока не потребуется; например, GetCount/GetAt или GetValue, где врожденное хранилище не удовлетворяет запросу. Примечание. GetValue может завершиться ошибкой из-за проблем с доступом к файлу.

Значение для других папок. Если у папки есть ресурсоемкие свойства, например делегирование файловой папке или сетевому доступу, она может оптимизировать производительность за счет поддержки IDelayedPropertyStoreFactory и разделения ее свойств на быстрое и медленное хранилище. Затем он может использовать отложенный MUX для их повторной раскомбинки.

Сочетание с другими флагами: не может быть объединено с GPS_TEMPORARY или GPS_READWRITE.
GPS_BESTEFFORT
Значение: 0x40
Значение для вызывающего процесса. Успешное получение хранилища, даже если некоторые свойства не возвращаются. Примечание. Некоторые значения могут отличаться или отсутствовать по сравнению с хранилищем без этого флага.



Значение папки файлов: выполните успешно и верните хранилище, даже если во время создания обработчика или врожденного хранилища произошла ошибка. Сбой только в том случае, если не удается выполнить подсхранилища.

Значение для других папок: успешное получение хранилища, даже если некоторые свойства не возвращаются.

Сочетание с другими флагами: не может быть объединено с GPS_TEMPORARY, GPS_READWRITE или GPS_HANDLERPROPERTIESONLY.
GPS_NO_OPLOCK
Значение: 0x80
Windows 7 и более поздних версий. Вызывающие пользователи должны использовать этот флаг только в том случае, если они уже удерживают оппортунистическую блокировку (oplock) в файле, так как без блокировки операция привязки не может продолжаться. По умолчанию оболочка запрашивает блокировку файла перед привязкой к обработчику свойств. Этот флаг отключает поведение по умолчанию.

Windows Server 2008 и Windows Vista: Этот флаг недоступен.
GPS_PREFERQUERYPROPERTIES
Значение: 0x100
Windows 8 и более поздних версий. Используйте этот флаг для получения только свойств из индексатора для результатов WDS.
GPS_EXTRINSICPROPERTIES
Значение: 0x200
Включите свойства из вторичного потока файла.
GPS_EXTRINSICPROPERTIESONLY
Значение: 0x400
Включите только свойства из вторичного потока файла.
GPS_VOLATILEPROPERTIES
Значение: 0x800
GPS_VOLATILEPROPERTIESONLY
Значение: 0x1000
GPS_MASK_VALID
Значение: 0x1fff
Маска для допустимых значений GETPROPERTYSTOREFLAGS .

Комментарии

Если элемент оболочки является файлом, хранилище свойств содержит следующие элементы.

  • Свойства файловой системы, касающиеся файла.
  • Свойства из самого файла, предоставляемые обработчиком свойств файла, если файл не находится в автономном режиме (см. GPS_OPENSLOWITEM).
Элементы оболочки, не относящиеся к файлам, возвращают аналогичное хранилище только для чтения.
Примечание GPS_INCLUDEOFFLINEPROPERTIES была заменена GPS_OPENSLOWITEM.
 

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Верхняя часть propsys.h