SFGAO

SFGAO Bitfeldwerte stellen Attribute dar, die für ein Element (Datei oder Ordner) oder eine Gruppe von Elementen abgerufen werden können. Sie werden mit den IShellFolder- und IShellItem-APIs verwendet, insbesondere mit IShellFolder::GetAttributesOf und IShellItem::GetAttributes.

Konstante/Wert BESCHREIBUNG
SFGAO_CANCOPY
0x00000001
Die angegebenen Elemente können kopiert werden.
SFGAO_CANMOVE
0x00000002
Die angegebenen Elemente können verschoben werden.
SFGAO_CANLINK
0x00000004
Für die angegebenen Elemente können Verknüpfungen erstellt werden. Dieses Attribut hat den gleichen Wert wie DROPEFFECT_LINK.
Wenn eine Namespaceerweiterung dieses Attribut zurückgibt, wird dem Kontextmenü, das bei Drag-and-Drop-Vorgängen angezeigt wird, ein Eintrag Verknüpfung erstellen mit einem Standardhandler hinzugefügt. Die Erweiterung kann auch einen eigenen Handler für das Linkverb anstelle des Standardwerts implementieren. Wenn die Erweiterung dies tut, ist sie für das Erstellen der Verknüpfung verantwortlich.
Das Element Verknüpfung erstellen wird auch zum Windows Explorer-Menü Datei und zu normalen Kontextmenüs hinzugefügt.
Wenn das Element ausgewählt ist, wird die IContextMenu::InvokeCommand-Methode Ihrer Anwendung aufgerufen, wobei das lpVerb-Element der CMINVOKECOMMANDINFO-Struktur auf link festgelegt ist. Ihre Anwendung ist für das Erstellen des Links verantwortlich.
SFGAO_STORAGE
0x00000008
Die angegebenen Elemente können über IShellFolder::BindToObject an ein IStorage-Objekt gebunden werden. Weitere Informationen zu Namespacebearbeitungsfunktionen finden Sie unter IStorage.
SFGAO_CANRENAME
0x00000010
Die angegebenen Elemente können umbenannt werden. Beachten Sie, dass dieser Wert im Wesentlichen ein Vorschlag ist. nicht alle Namespaceclients lassen die Umbenennung von Elementen zu. Für diejenigen, die dies tun, muss dieses Attribut jedoch festgelegt sein.
SFGAO_CANDELETE
0x00000020
Die angegebenen Elemente können gelöscht werden.
SFGAO_HASPROPSHEET
0x00000040
Die angegebenen Elemente verfügen über Eigenschaftenblätter.
SFGAO_DROPTARGET
0x00000100
Die angegebenen Elemente sind Ablageziele.
SFGAO_CAPABILITYMASK
0x00000177
Dieses Flag ist eine Maske für die Funktionsattribute: SFGAO_CANCOPY, SFGAO_CANMOVE, SFGAO_CANLINK, SFGAO_CANRENAME, SFGAO_CANDELETE, SFGAO_HASPROPSHEET und SFGAO_DROPTARGET. Aufrufer verwenden diesen Wert normalerweise nicht.
SFGAO_SYSTEM
0x00001000
Windows 7 und höher. Die angegebenen Elemente sind Systemelemente.
SFGAO_ENCRYPTED
0x00002000
Die angegebenen Elemente sind verschlüsselt und erfordern möglicherweise eine spezielle Präsentation.
SFGAO_ISSLOW
0x00004000
Der Zugriff auf das Element (über IStream oder andere Speicherschnittstellen) wird voraussichtlich ein langsamer Vorgang sein. Anwendungen sollten den Zugriff auf Elemente vermeiden, die mit SFGAO_ISSLOW gekennzeichnet sind.
Hinweis: Das Öffnen eines Datenstroms für ein Element ist in der Regel immer ein langsamer Vorgang. SFGAO_ISSLOW gibt an, dass es besonders langsam ist, z. B. bei langsamen Netzwerkverbindungen oder Offlinedateien (FILE_ATTRIBUTE_OFFLINE). Das Abfragen SFGAO_ISSLOW ist jedoch selbst ein langsamer Vorgang. Anwendungen sollten SFGAO_ISSLOW nur in einem Hintergrundthread abfragen. Anstelle eines Methodenaufrufs, der SFGAO_ISSLOW umfasst, kann eine alternative Methode verwendet werden, z. B. das Abrufen der PKEY_FileAttributes-Eigenschaft und das Testen auf FILE_ATTRIBUTE_OFFLINE.
SFGAO_GHOSTED
0x00008000
Die angegebenen Elemente werden als abgeblendet und für den Benutzer nicht verfügbar angezeigt.
SFGAO_LINK
0x00010000
Die angegebenen Elemente sind Verknüpfungen.
SFGAO_SHARE
0x00020000
Die angegebenen Objekte werden freigegeben.
SFGAO_READONLY
0x00040000
Die angegebenen Elemente sind schreibgeschützt. Bei Ordnern bedeutet dies, dass in diesen Ordnern keine neuen Elemente erstellt werden können. Dies sollte nicht mit dem Verhalten verwechselt werden, das durch das von IColumnProvider::GetItemData in einer SHCOLUMNDATA-Struktur abgerufene FILE_ATTRIBUTE_READONLY-Flag angegeben wird. FILE_ATTRIBUTE_READONLY hat keine Bedeutung für Win32-Dateisystemordner.
SFGAO_HIDDEN
0x00080000
Das Element ist ausgeblendet und sollte nicht angezeigt werden, es sei denn, die Option Ausgeblendete Dateien und Ordner anzeigen ist in den Ordnereinstellungen aktiviert.
SFGAO_DISPLAYATTRMASK
0x000FC000
Darf nicht verwendet werden.
SFGAO_NONENUMERATED
0x00100000
Die Elemente sind nicht aufgezählte Elemente und sollten ausgeblendet werden. Sie werden nicht über einen Enumerator zurückgegeben, wie er von der IShellFolder::EnumObjects-Methode erstellt wurde.
SFGAO_NEWCONTENT
0x00200000
Die Elemente enthalten neue Inhalte, wie von der jeweiligen Anwendung definiert.
SFGAO_CANMONIKER
Wird nicht unterstützt.
SFGAO_HASSTORAGE
Wird nicht unterstützt.
SFGAO_STREAM
0x00400000
Gibt an, dass dem Element ein Stream zugeordnet ist. Auf diesen Stream kann über einen Aufruf von IShellFolder::BindToObject oder IShellItem::BindToHandler mit IID_IStream im riid-Parameter zugegriffen werden.
SFGAO_STORAGEANCESTOR
0x00800000
Auf untergeordnete Elemente dieses Elements kann über IStream oder IStorage zugegriffen werden. Diese untergeordneten Elemente werden mit SFGAO_STORAGE oder SFGAO_STREAM gekennzeichnet.
SFGAO_VALIDATE
0x01000000
Bei Angabe als Eingabe weist SFGAO_VALIDATE den Ordner an, zu überprüfen, ob die in einem Ordner oder Shellelementarray enthaltenen Elemente vorhanden sind. Wenn eines oder mehrere dieser Elemente nicht vorhanden sind, geben IShellFolder::GetAttributesOf und IShellItemArray::GetAttributes einen Fehlercode zurück. Dieses Flag wird nie als [out]-Wert zurückgegeben.
Bei Verwendung mit dem Dateisystemordner weist SFGAO_VALIDATE den Ordner an, zwischengespeicherte Eigenschaften zu verwerfen, die von Clients von IShellFolder2::GetDetailsEx abgerufen wurden, die sich möglicherweise für die angegebenen Elemente angesammelt haben.
SFGAO_REMOVABLE
0x02000000
Die angegebenen Elemente befinden sich auf Wechselmedien oder sind selbst Wechselmedien.
SFGAO_COMPRESSED
0x04000000
Die angegebenen Elemente werden komprimiert.
SFGAO_BROWSABLE
0x08000000
Die angegebenen Elemente können in einem Webbrowser oder windows Explorer Frame gehostet werden.
SFGAO_FILESYSANCESTOR
0x10000000
Die angegebenen Ordner sind entweder Dateisystemordner oder enthalten mindestens einen untergeordneten Ordner (untergeordnetes Kind, Enkelkind oder höher), bei dem es sich um einen Dateisystemordner (SFGAO_FILESYSTEM) handelt.
SFGAO_FOLDER
0x20000000
Die angegebenen Elemente sind Ordner. Einige Elemente können sowohl mit SFGAO_STREAM als auch mit SFGAO_FOLDER gekennzeichnet werden, z. B. eine komprimierte Datei mit einer .zip Dateinamenerweiterung. Einige Anwendungen können dieses Flag enthalten, wenn sie auf Elemente testen, die sowohl Dateien als auch Container sind.
SFGAO_FILESYSTEM
0x40000000
Die angegebenen Ordner oder Dateien sind Teil des Dateisystems (d. a. Dateien, Verzeichnisse oder Stammverzeichnisse). Die analysierten Namen der Elemente können als gültige Win32-Dateisystempfade angenommen werden. Diese Pfade können entweder UNC oder laufwerksbuchstabenbasiert sein.
SFGAO_STORAGECAPMASK
0x70C50008
Dieses Flag ist eine Maske für die Speicherfunktionsattribute: SFGAO_STORAGE, SFGAO_LINK, SFGAO_READONLY, SFGAO_STREAM, SFGAO_STORAGEANCESTOR, SFGAO_FILESYSANCESTOR, SFGAO_FOLDER und SFGAO_FILESYSTEM. Aufrufer verwenden diesen Wert normalerweise nicht.
SFGAO_HASSUBFOLDER
0x80000000
Die angegebenen Ordner verfügen über Unterordner. Das attribut SFGAO_HASSUBFOLDER ist nur ein Hinweis und kann von Shellordnerimplementierungen zurückgegeben werden, auch wenn sie keine Unterordner enthalten. Beachten Sie jedoch, dass umgekehrt – SFGAO_HASSUBFOLDER nicht zurückgegeben werden – definitiv angibt, dass die Ordnerobjekte keine Unterordner haben.
Die Rückgabe von SFGAO_HASSUBFOLDER wird empfohlen, wenn ein erheblicher Zeitraum erforderlich ist, um zu bestimmen, ob Unterordner vorhanden sind. Beispielsweise gibt die Shell immer SFGAO_HASSUBFOLDER zurück, wenn sich ein Ordner auf einem Netzlaufwerk befindet.
SFGAO_CONTENTSMASK
0x80000000
Dieses Flag ist eine Maske für Inhaltsattribute, derzeit nur SFGAO_HASSUBFOLDER. Aufrufer verwenden diesen Wert normalerweise nicht.
SFGAO_PKEYSFGAOMASK
0x81044000
Maskierung, die von der PKEY_SFGAOFlags-Eigenschaft verwendet wird, um Attribute zu bestimmen, die als Ursache für langsame Berechnungen oder fehlenden Kontext gelten: SFGAO_ISSLOW, SFGAO_READONLY, SFGAO_HASSUBFOLDER und SFGAO_VALIDATE. Aufrufer verwenden diesen Wert normalerweise nicht.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Server 2008 [nur Desktop-Apps]
Header
Shobjidl.h
IDL
Shobjidl.idl

Weitere Informationen

IShellFolder::GetAttributesOf

IShellFolder::P arseDisplayName

IShellItem::GetAttributes

IShellItemArray::GetAttributes