Прочитать на английском

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


SFGAO

SFGAO Значения bitfield представляют атрибуты, которые можно получить из элемента (файла или папки) или набора элементов. Они используются с API IShellFolder и IShellItem, в первую очередь iShellFolder::GetAttributesOf и IShellItem::GetAttributes.

Констант/значение Описание
SFGAO_CANCOPY
0x00000001
Указанные элементы можно скопировать.
SFGAO_CANMOVE
0x00000002
Указанные элементы можно перемещать.
SFGAO_CANLINK
0x00000004
Для указанных элементов можно создать ярлыки. Этот атрибут имеет то же значение, что и DROPEFFECT_LINK.
Если расширение пространства имен возвращает этот атрибут, в контекстное меню, отображаемое во время операций перетаскивания, добавляется запись Создать ярлык с обработчиком по умолчанию. Расширение также может реализовать собственный обработчик для команды ссылки вместо стандартного. Если расширение делает это, оно отвечает за создание ярлыка.
Элемент Создать ярлык также добавляется в меню Файл windows Обозреватель и в обычные контекстные меню.
Если выбран элемент, вызывается метод IContextMenu::InvokeCommand приложения с элементом lpVerb структуры CMINVOKECOMMANDINFO , заданной для связывания. Ваше приложение отвечает за создание ссылки.
SFGAO_STORAGE
0x00000008
Указанные элементы можно привязать к объекту IStorage с помощью IShellFolder::BindToObject. Дополнительные сведения о возможностях управления пространством имен см. в разделе IStorage.
SFGAO_CANRENAME
0x00000010
Указанные элементы можно переименовать. Обратите внимание, что это значение по сути является предложением; Не все клиенты пространства имен разрешают переименование элементов. Однако эти атрибуты должны быть заданы.
SFGAO_CANDELETE
0x00000020
Указанные элементы можно удалить.
SFGAO_HASPROPSHEET
0x00000040
Указанные элементы имеют листы свойств.
SFGAO_DROPTARGET
0x00000100
Указанные элементы являются целевыми объектами удаления.
SFGAO_CAPABILITYMASK
0x00000177
Этот флаг является маской для атрибутов возможностей: SFGAO_CANCOPY, SFGAO_CANMOVE, SFGAO_CANLINK, SFGAO_CANRENAME, SFGAO_CANDELETE, SFGAO_HASPROPSHEET и SFGAO_DROPTARGET. Вызывающие абоненты обычно не используют это значение.
SFGAO_SYSTEM
0x00001000
Windows 7 и более поздних версий. Указанные элементы являются системным элементом.
SFGAO_ENCRYPTED
0x00002000
Указанные элементы зашифрованы и могут потребовать специального представления.
SFGAO_ISSLOW
0x00004000
Ожидается, что доступ к элементу (через IStream или другие интерфейсы хранилища) будет медленным. Приложения должны избегать доступа к элементам, помеченным SFGAO_ISSLOW.
Примечание: Открытие потока для элемента обычно выполняется медленно. SFGAO_ISSLOW указывает, что ожидается, что она будет особенно медленной, например в случае медленного сетевого подключения или автономных (FILE_ATTRIBUTE_OFFLINE) файлов. Однако запрос SFGAO_ISSLOW сам по себе является медленной операцией. Приложения должны запрашивать SFGAO_ISSLOW только в фоновом потоке. Вместо вызова метода, который включает SFGAO_ISSLOW, можно использовать альтернативный метод, например получение свойства PKEY_FileAttributes и тестирование FILE_ATTRIBUTE_OFFLINE.
SFGAO_GHOSTED
0x00008000
Указанные элементы отображаются как неактивные и недоступные пользователю.
SFGAO_LINK
0x00010000
Указанные элементы являются ярлыками.
SFGAO_SHARE
0x00020000
Указанные объекты являются общими.
SFGAO_READONLY
0x00040000
Указанные элементы доступны только для чтения. В случае папок это означает, что новые элементы не могут быть созданы в этих папках. Это не следует путать с поведением, заданным флагом FILE_ATTRIBUTE_READONLY, извлекаемым IColumnProvider::GetItemData в структуре SHCOLUMNDATA . FILE_ATTRIBUTE_READONLY не имеет значения для папок файловой системы Win32.
SFGAO_HIDDEN
0x00080000
Элемент скрыт и не должен отображаться, если в параметрах папки не включен параметр Показать скрытые файлы и папки.
SFGAO_DISPLAYATTRMASK
0x000FC000
Не используйте.
SFGAO_NONENUMERATED
0x00100000
Элементы являются нечислированными элементами и должны быть скрыты. Они не возвращаются с помощью перечислителя, например, созданного методом IShellFolder::EnumObjects .
SFGAO_NEWCONTENT
0x00200000
Элементы содержат новое содержимое в соответствии с определением конкретного приложения.
SFGAO_CANMONIKER
Не поддерживается.
SFGAO_HASSTORAGE
Не поддерживается.
SFGAO_STREAM
0x00400000
Указывает, что элемент имеет связанный с ним поток. Доступ к потоку можно получить через вызов IShellFolder::BindToObject или IShellItem::BindToHandler с IID_IStream в параметре riid .
SFGAO_STORAGEANCESTOR
0x00800000
Дочерние элементы этого элемента доступны через IStream или IStorage. Эти дочерние элементы помечены SFGAO_STORAGE или SFGAO_STREAM.
SFGAO_VALIDATE
0x01000000
При указании в качестве входных данных SFGAO_VALIDATE указывает папке, чтобы убедиться, что элементы, содержащиеся в папке или массиве элементов оболочки, существуют. Если один или несколько из этих элементов не существуют, IShellFolder::GetAttributesOf и IShellItemArray::GetAttributes возвращают код сбоя. Этот флаг никогда не возвращается в виде значения [out].
При использовании с папкой файловой системы SFGAO_VALIDATE указывает папке удалить кэшированные свойства, полученные клиентами IShellFolder2::GetDetailsEx , которые могли накапливаться для указанных элементов.
SFGAO_REMOVABLE
0x02000000
Указанные элементы находятся на съемном носителе или сами являются съемными устройствами.
SFGAO_COMPRESSED
0x04000000
Указанные элементы сжимаются.
SFGAO_BROWSABLE
0x08000000
Указанные элементы могут размещаться в веб-браузере или в фрейме Windows Обозреватель.
SFGAO_FILESYSANCESTOR
0x10000000
Указанные папки являются папками файловой системы или содержат по крайней мере один потомок (дочерний, внук или более поздний), который является папкой файловой системы (SFGAO_FILESYSTEM).
SFGAO_FOLDER
0x20000000
Указанные элементы являются папками. Некоторые элементы можно пометить как SFGAO_STREAM, так и SFGAO_FOLDER, например сжатый файл с расширением имени .zip. Некоторые приложения могут включать этот флаг при тестировании элементов, которые являются файлами и контейнерами.
SFGAO_FILESYSTEM
0x40000000
Указанные папки или файлы являются частью файловой системы (то есть это файлы, каталоги или корневые каталоги). Проанализированные имена элементов можно считать допустимыми путями файловой системы Win32. Эти пути могут быть либо UNC, либо буквами диска.
SFGAO_STORAGECAPMASK
0x70C50008
Этот флаг является маской для атрибутов возможностей хранения: SFGAO_STORAGE, SFGAO_LINK, SFGAO_READONLY, SFGAO_STREAM, SFGAO_STORAGEANCESTOR, SFGAO_FILESYSANCESTOR, SFGAO_FOLDER и SFGAO_FILESYSTEM. Вызывающие абоненты обычно не используют это значение.
SFGAO_HASSUBFOLDER
0x80000000
Указанные папки имеют вложенные папки. Атрибут SFGAO_HASSUBFOLDER является только рекомендаемым и может возвращаться реализациями папок оболочки, даже если они не содержат вложенных папок. Однако обратите внимание, что в обратном варианте (не удается вернуть SFGAO_HASSUBFOLDER) окончательно указывается, что объекты папки не имеют вложенных папок.
Возвращать SFGAO_HASSUBFOLDER рекомендуется всякий раз, когда требуется значительное количество времени, чтобы определить, существуют ли какие-либо вложенные папки. Например, оболочка всегда возвращает SFGAO_HASSUBFOLDER, если папка находится на сетевом диске.
SFGAO_CONTENTSMASK
0x80000000
Этот флаг является маской для атрибутов содержимого, в настоящее время SFGAO_HASSUBFOLDER. Вызывающие абоненты обычно не используют это значение.
SFGAO_PKEYSFGAOMASK
0x81044000
Маска, используемая свойством PKEY_SFGAOFlags для определения атрибутов, которые считаются причиной замедления вычислений или отсутствия контекста: SFGAO_ISSLOW, SFGAO_READONLY, SFGAO_HASSUBFOLDER и SFGAO_VALIDATE. Вызывающие абоненты обычно не используют это значение.

Требования

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

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

IShellFolder::GetAttributesOf

IShellFolder::P arseDisplayName

IShellItem::GetAttributes

IShellItemArray::GetAttributes