SFGAO
SFGAO Значения bitfield представляют атрибуты, которые можно получить из элемента (файла или папки) или набора элементов. Они используются с API IShellFolder и IShellItem, в первую очередь iShellFolder::GetAttributesOf и IShellItem::GetAttributes.
| Констант/значение | Описание |
|---|---|
|
Указанные элементы можно скопировать. |
|
Указанные элементы можно перемещать. |
|
Для указанных элементов можно создать ярлыки. Этот атрибут имеет то же значение, что и DROPEFFECT_LINK. Если расширение пространства имен возвращает этот атрибут, в контекстное меню, отображаемое во время операций перетаскивания, добавляется запись Создать ярлык с обработчиком по умолчанию. Расширение также может реализовать собственный обработчик для команды ссылки вместо стандартного. Если расширение делает это, оно отвечает за создание ярлыка. Элемент Создать ярлык также добавляется в меню Файл windows Обозреватель и в обычные контекстные меню. Если выбран элемент, вызывается метод IContextMenu::InvokeCommand приложения с элементом lpVerb структуры CMINVOKECOMMANDINFO , заданной для связывания. Ваше приложение отвечает за создание ссылки. |
|
Указанные элементы можно привязать к объекту IStorage с помощью IShellFolder::BindToObject. Дополнительные сведения о возможностях управления пространством имен см. в разделе IStorage. |
|
Указанные элементы можно переименовать. Обратите внимание, что это значение по сути является предложением; Не все клиенты пространства имен разрешают переименование элементов. Однако эти атрибуты должны быть заданы. |
|
Указанные элементы можно удалить. |
|
Указанные элементы имеют листы свойств. |
|
Указанные элементы являются целевыми объектами удаления. |
|
Этот флаг является маской для атрибутов возможностей: SFGAO_CANCOPY, SFGAO_CANMOVE, SFGAO_CANLINK, SFGAO_CANRENAME, SFGAO_CANDELETE, SFGAO_HASPROPSHEET и SFGAO_DROPTARGET. Вызывающие абоненты обычно не используют это значение. |
|
Windows 7 и более поздних версий. Указанные элементы являются системным элементом. |
|
Указанные элементы зашифрованы и могут потребовать специального представления. |
| SFGAO_ISSLOW 0x00004000 |
Ожидается, что доступ к элементу (через IStream или другие интерфейсы хранилища) будет медленным. Приложения должны избегать доступа к элементам, помеченным SFGAO_ISSLOW. Примечание: Открытие потока для элемента обычно выполняется медленно. SFGAO_ISSLOW указывает, что ожидается, что она будет особенно медленной, например в случае медленного сетевого подключения или автономных (FILE_ATTRIBUTE_OFFLINE) файлов. Однако запрос SFGAO_ISSLOW сам по себе является медленной операцией. Приложения должны запрашивать SFGAO_ISSLOW только в фоновом потоке. Вместо вызова метода, который включает SFGAO_ISSLOW, можно использовать альтернативный метод, например получение свойства PKEY_FileAttributes и тестирование FILE_ATTRIBUTE_OFFLINE. |
|
Указанные элементы отображаются как неактивные и недоступные пользователю. |
|
Указанные элементы являются ярлыками. |
|
Указанные объекты являются общими. |
|
Указанные элементы доступны только для чтения. В случае папок это означает, что новые элементы не могут быть созданы в этих папках. Это не следует путать с поведением, заданным флагом FILE_ATTRIBUTE_READONLY, извлекаемым IColumnProvider::GetItemData в структуре SHCOLUMNDATA . FILE_ATTRIBUTE_READONLY не имеет значения для папок файловой системы Win32. |
|
Элемент скрыт и не должен отображаться, если в параметрах папки не включен параметр Показать скрытые файлы и папки. |
|
Не используйте. |
|
Элементы являются нечислированными элементами и должны быть скрыты. Они не возвращаются с помощью перечислителя, например, созданного методом IShellFolder::EnumObjects . |
|
Элементы содержат новое содержимое в соответствии с определением конкретного приложения. |
|
Не поддерживается. |
|
Не поддерживается. |
|
Указывает, что элемент имеет связанный с ним поток. Доступ к потоку можно получить через вызов IShellFolder::BindToObject или IShellItem::BindToHandler с IID_IStream в параметре riid . |
|
Дочерние элементы этого элемента доступны через IStream или IStorage. Эти дочерние элементы помечены SFGAO_STORAGE или SFGAO_STREAM. |
|
При указании в качестве входных данных SFGAO_VALIDATE указывает папке, чтобы убедиться, что элементы, содержащиеся в папке или массиве элементов оболочки, существуют. Если один или несколько из этих элементов не существуют, IShellFolder::GetAttributesOf и IShellItemArray::GetAttributes возвращают код сбоя. Этот флаг никогда не возвращается в виде значения [out]. При использовании с папкой файловой системы SFGAO_VALIDATE указывает папке удалить кэшированные свойства, полученные клиентами IShellFolder2::GetDetailsEx , которые могли накапливаться для указанных элементов. |
|
Указанные элементы находятся на съемном носителе или сами являются съемными устройствами. |
|
Указанные элементы сжимаются. |
|
Указанные элементы могут размещаться в веб-браузере или в фрейме Windows Обозреватель. |
|
Указанные папки являются папками файловой системы или содержат по крайней мере один потомок (дочерний, внук или более поздний), который является папкой файловой системы (SFGAO_FILESYSTEM). |
|
Указанные элементы являются папками. Некоторые элементы можно пометить как SFGAO_STREAM, так и SFGAO_FOLDER, например сжатый файл с расширением имени .zip. Некоторые приложения могут включать этот флаг при тестировании элементов, которые являются файлами и контейнерами. |
|
Указанные папки или файлы являются частью файловой системы (то есть это файлы, каталоги или корневые каталоги). Проанализированные имена элементов можно считать допустимыми путями файловой системы Win32. Эти пути могут быть либо UNC, либо буквами диска. |
|
Этот флаг является маской для атрибутов возможностей хранения: SFGAO_STORAGE, SFGAO_LINK, SFGAO_READONLY, SFGAO_STREAM, SFGAO_STORAGEANCESTOR, SFGAO_FILESYSANCESTOR, SFGAO_FOLDER и SFGAO_FILESYSTEM. Вызывающие абоненты обычно не используют это значение. |
|
Указанные папки имеют вложенные папки. Атрибут SFGAO_HASSUBFOLDER является только рекомендаемым и может возвращаться реализациями папок оболочки, даже если они не содержат вложенных папок. Однако обратите внимание, что в обратном варианте (не удается вернуть SFGAO_HASSUBFOLDER) окончательно указывается, что объекты папки не имеют вложенных папок. Возвращать SFGAO_HASSUBFOLDER рекомендуется всякий раз, когда требуется значительное количество времени, чтобы определить, существуют ли какие-либо вложенные папки. Например, оболочка всегда возвращает SFGAO_HASSUBFOLDER, если папка находится на сетевом диске. |
|
Этот флаг является маской для атрибутов содержимого, в настоящее время SFGAO_HASSUBFOLDER. Вызывающие абоненты обычно не используют это значение. |
|
Маска, используемая свойством PKEY_SFGAOFlags для определения атрибутов, которые считаются причиной замедления вычислений или отсутствия контекста: SFGAO_ISSLOW, SFGAO_READONLY, SFGAO_HASSUBFOLDER и SFGAO_VALIDATE. Вызывающие абоненты обычно не используют это значение. |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows Vista [только классические приложения] |
| Минимальная версия сервера |
Windows Server 2008 [только классические приложения] |
| Заголовок |
|
| IDL |
|
См. также раздел
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по