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 |
---|---|
|
Die angegebenen Elemente können kopiert werden. |
|
Die angegebenen Elemente können verschoben werden. |
|
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. |
|
Die angegebenen Elemente können über IShellFolder::BindToObject an ein IStorage-Objekt gebunden werden. Weitere Informationen zu Namespacebearbeitungsfunktionen finden Sie unter IStorage. |
|
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. |
|
Die angegebenen Elemente können gelöscht werden. |
|
Die angegebenen Elemente verfügen über Eigenschaftenblätter. |
|
Die angegebenen Elemente sind Ablageziele. |
|
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. |
|
Windows 7 und höher. Die angegebenen Elemente sind Systemelemente. |
|
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. |
|
Die angegebenen Elemente werden als abgeblendet und für den Benutzer nicht verfügbar angezeigt. |
|
Die angegebenen Elemente sind Verknüpfungen. |
|
Die angegebenen Objekte werden freigegeben. |
|
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. |
|
Das Element ist ausgeblendet und sollte nicht angezeigt werden, es sei denn, die Option Ausgeblendete Dateien und Ordner anzeigen ist in den Ordnereinstellungen aktiviert. |
|
Darf nicht verwendet werden. |
|
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. |
|
Die Elemente enthalten neue Inhalte, wie von der jeweiligen Anwendung definiert. |
|
Wird nicht unterstützt. |
|
Wird nicht unterstützt. |
|
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. |
|
Auf untergeordnete Elemente dieses Elements kann über IStream oder IStorage zugegriffen werden. Diese untergeordneten Elemente werden mit SFGAO_STORAGE oder SFGAO_STREAM gekennzeichnet. |
|
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. |
|
Die angegebenen Elemente befinden sich auf Wechselmedien oder sind selbst Wechselmedien. |
|
Die angegebenen Elemente werden komprimiert. |
|
Die angegebenen Elemente können in einem Webbrowser oder windows Explorer Frame gehostet werden. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Dieses Flag ist eine Maske für Inhaltsattribute, derzeit nur SFGAO_HASSUBFOLDER. Aufrufer verwenden diesen Wert normalerweise nicht. |
|
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. |
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) |
Windows Vista [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) |
Windows Server 2008 [nur Desktop-Apps] |
Header |
|
IDL |
|