Lire en anglais

Partager via


SFGAO

SFGAO Les valeurs de champ de bits représentent des attributs qui peuvent être récupérés sur un élément (fichier ou dossier) ou un ensemble d’éléments. Elles sont utilisées avec les API IShellFolder et IShellItem, notamment IShellFolder::GetAttributesOf et IShellItem::GetAttributes.

Constante/valeur Description
SFGAO_CANCOPY
0x00000001
Les éléments spécifiés peuvent être copiés.
SFGAO_CANMOVE
0x00000002
Les éléments spécifiés peuvent être déplacés.
SFGAO_CANLINK
0x00000004
Des raccourcis peuvent être créés pour les éléments spécifiés. Cet attribut a la même valeur que DROPEFFECT_LINK.
Si une extension d’espace de noms retourne cet attribut, une entrée Créer un raccourci avec un gestionnaire par défaut est ajoutée au menu contextuel qui s’affiche pendant les opérations de glisser-déplacer. L’extension peut également implémenter son propre gestionnaire pour le verbe de lien à la place de la valeur par défaut. Si l’extension le fait, elle est responsable de la création du raccourci.
Un élément Créer un raccourci est également ajouté au menu Fichier de Windows Explorer et aux menus contextuels normaux.
Si l’élément est sélectionné, la méthode IContextMenu::InvokeCommand de votre application est appelée avec le membre lpVerb de la structure CMINVOKECOMMANDINFO défini sur liaison. Votre application est responsable de la création du lien.
SFGAO_STORAGE
0x00000008
Les éléments spécifiés peuvent être liés à un objet IStorage via IShellFolder::BindToObject. Pour plus d’informations sur les fonctionnalités de manipulation d’espace de noms, consultez IStorage.
SFGAO_CANRENAME
0x00000010
Les éléments spécifiés peuvent être renommés. Notez que cette valeur est essentiellement une suggestion ; tous les clients d’espace de noms n’autorisent pas le renommage des éléments. Toutefois, ceux qui le font doivent avoir cet attribut défini.
SFGAO_CANDELETE
0x00000020
Les éléments spécifiés peuvent être supprimés.
SFGAO_HASPROPSHEET
0x00000040
Les éléments spécifiés ont des feuilles de propriétés.
SFGAO_DROPTARGET
0x00000100
Les éléments spécifiés sont des cibles de suppression.
SFGAO_CAPABILITYMASK
0x00000177
Cet indicateur est un masque pour les attributs de fonctionnalité : SFGAO_CANCOPY, SFGAO_CANMOVE, SFGAO_CANLINK, SFGAO_CANRENAME, SFGAO_CANDELETE, SFGAO_HASPROPSHEET et SFGAO_DROPTARGET. Normalement, les appelants n’utilisent pas cette valeur.
SFGAO_SYSTEM
0x00001000
Windows 7 et versions ultérieures. Les éléments spécifiés sont des éléments système.
SFGAO_ENCRYPTED
0x00002000
Les éléments spécifiés sont chiffrés et peuvent nécessiter une présentation spéciale.
SFGAO_ISSLOW
0x00004000
L’accès à l’élément (via IStream ou d’autres interfaces de stockage) est censé être une opération lente. Les applications doivent éviter d’accéder aux éléments marqués d’un indicateur SFGAO_ISSLOW.
Note: L’ouverture d’un flux pour un élément est généralement une opération lente à tout moment. SFGAO_ISSLOW indique qu’elle devrait être particulièrement lente, par exemple dans le cas de connexions réseau lentes ou de fichiers hors connexion (FILE_ATTRIBUTE_OFFLINE). Toutefois, l’interrogation de SFGAO_ISSLOW est en soi une opération lente. Les applications doivent interroger SFGAO_ISSLOW uniquement sur un thread d’arrière-plan. Une autre méthode, telle que la récupération de la propriété PKEY_FileAttributes et le test de FILE_ATTRIBUTE_OFFLINE, peut être utilisée à la place d’un appel de méthode qui implique SFGAO_ISSLOW.
SFGAO_GHOSTED
0x00008000
Les éléments spécifiés sont affichés comme grisés et non disponibles pour l’utilisateur.
SFGAO_LINK
0x00010000
Les éléments spécifiés sont des raccourcis.
SFGAO_SHARE
0x00020000
Les objets spécifiés sont partagés.
SFGAO_READONLY
0x00040000
Les éléments spécifiés sont en lecture seule. Dans le cas des dossiers, cela signifie que de nouveaux éléments ne peuvent pas être créés dans ces dossiers. Cela ne doit pas être confondu avec le comportement spécifié par l’indicateur FILE_ATTRIBUTE_READONLY récupéré par IColumnProvider::GetItemData dans une structure SHCOLUMNDATA . FILE_ATTRIBUTE_READONLY n’a aucune signification pour les dossiers de système de fichiers Win32.
SFGAO_HIDDEN
0x00080000
L’élément est masqué et ne doit pas être affiché, sauf si l’option Afficher les fichiers et dossiers masqués est activée dans Paramètres du dossier.
SFGAO_DISPLAYATTRMASK
0x000FC000
Ne pas utiliser.
SFGAO_NONENUMERATED
0x00100000
Les éléments ne sont pas des élémentsnumérés et doivent être masqués. Elles ne sont pas retournées par le biais d’un énumérateur tel que celui créé par la méthode IShellFolder::EnumObjects .
SFGAO_NEWCONTENT
0x00200000
Les éléments contiennent un nouveau contenu, tel que défini par l’application particulière.
SFGAO_CANMONIKER
Non pris en charge.
SFGAO_HASSTORAGE
Non pris en charge.
SFGAO_STREAM
0x00400000
Indique qu’un flux est associé à l’élément. Ce flux est accessible via un appel à IShellFolder::BindToObject ou IShellItem::BindToHandler avec IID_IStream dans le paramètre riid .
SFGAO_STORAGEANCESTOR
0x00800000
Les enfants de cet élément sont accessibles via IStream ou IStorage. Ces enfants sont marqués de SFGAO_STORAGE ou de SFGAO_STREAM.
SFGAO_VALIDATE
0x01000000
Lorsqu’il est spécifié en tant qu’entrée, SFGAO_VALIDATE indique au dossier de vérifier que les éléments contenus dans un dossier ou un tableau d’éléments Shell existent. Si un ou plusieurs de ces éléments n’existent pas, IShellFolder::GetAttributesOf et IShellItemArray::GetAttributes retournent un code d’échec. Cet indicateur n’est jamais retourné en tant que valeur [out].
Lorsqu’il est utilisé avec le dossier du système de fichiers, SFGAO_VALIDATE indique au dossier d’ignorer les propriétés mises en cache récupérées par les clients d’IShellFolder2::GetDetailsEx qui peuvent s’être accumulées pour les éléments spécifiés.
SFGAO_REMOVABLE
0x02000000
Les éléments spécifiés se trouvent sur un support amovible ou sont eux-mêmes des appareils amovibles.
SFGAO_COMPRESSED
0x04000000
Les éléments spécifiés sont compressés.
SFGAO_BROWSABLE
0x08000000
Les éléments spécifiés peuvent être hébergés à l’intérieur d’un navigateur web ou d’un cadre Windows Explorer.
SFGAO_FILESYSANCESTOR
0x10000000
Les dossiers spécifiés sont des dossiers de système de fichiers ou contiennent au moins un descendant (enfant, petit-fils ou version ultérieure) qui est un dossier de système de fichiers (SFGAO_FILESYSTEM).
SFGAO_FOLDER
0x20000000
Les éléments spécifiés sont des dossiers. Certains éléments peuvent être marqués avec SFGAO_STREAM et SFGAO_FOLDER, comme un fichier compressé avec une extension de nom de fichier .zip. Certaines applications peuvent inclure cet indicateur lors du test d’éléments qui sont à la fois des fichiers et des conteneurs.
SFGAO_FILESYSTEM
0x40000000
Les dossiers ou fichiers spécifiés font partie du système de fichiers (c’est-à-dire, il s’agit de fichiers, de répertoires ou de répertoires racines). Les noms analysés des éléments peuvent être supposés être des chemins d’accès de système de fichiers Win32 valides. Ces chemins peuvent être basés sur unC ou sur une lettre de lecteur.
SFGAO_STORAGECAPMASK
0x70C50008
Cet indicateur est un masque pour les attributs de capacité de stockage : SFGAO_STORAGE, SFGAO_LINK, SFGAO_READONLY, SFGAO_STREAM, SFGAO_STORAGEANCESTOR, SFGAO_FILESYSANCESTOR, SFGAO_FOLDER et SFGAO_FILESYSTEM. Les appelants n’utilisent normalement pas cette valeur.
SFGAO_HASSUBFOLDER
0x80000000
Les dossiers spécifiés ont des sous-dossiers. L’attribut SFGAO_HASSUBFOLDER n’est qu’un avis et peut être retourné par les implémentations de dossiers Shell même si elles ne contiennent pas de sous-dossiers. Notez, toutefois, que l’inverse ( ne retournant pas SFGAO_HASSUBFOLDER ) indique définitivement que les objets de dossier n’ont pas de sous-dossiers.
Le retour SFGAO_HASSUBFOLDER est recommandé chaque fois qu’un délai important est nécessaire pour déterminer s’il existe des sous-dossiers. Par exemple, l’interpréteur de commandes retourne toujours SFGAO_HASSUBFOLDER lorsqu’un dossier se trouve sur un lecteur réseau.
SFGAO_CONTENTSMASK
0x80000000
Cet indicateur est un masque pour les attributs de contenu, actuellement uniquement SFGAO_HASSUBFOLDER. Les appelants n’utilisent normalement pas cette valeur.
SFGAO_PKEYSFGAOMASK
0x81044000
Masque utilisé par la propriété PKEY_SFGAOFlags pour déterminer les attributs qui sont considérés comme à l’origine de calculs lents ou d’un contexte manquant : SFGAO_ISSLOW, SFGAO_READONLY, SFGAO_HASSUBFOLDER et SFGAO_VALIDATE. Les appelants n’utilisent normalement pas cette valeur.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge
Windows Server 2008 [applications de bureau uniquement]
En-tête
Shobjidl.h
IDL
Shobjidl.idl

Voir aussi

IShellFolder::GetAttributesOf

IShellFolder::P arseDisplayName

IShellItem::GetAttributes

IShellItemArray::GetAttributes