SFGAO

Attributs qui peuvent être récupérés sur un élément (fichier ou dossier) ou sur un ensemble d’éléments.

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 de raccourci créer 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 Link à la place de la valeur par défaut. Si l’extension le fait, il est responsable de la création du raccourci.
un élément de raccourci créer est également ajouté au menu fichier de l’explorateur de Windows et aux menus contextuels normaux.
Si l’élément est sélectionné, la méthode IContextMenu :: commande InvokeCommand de votre application est appelée avec le membre lpVerb de la structure CMINVOKECOMMANDINFO défini sur Link. Votre application est chargée de créer le lien.
SFGAO_STORAGE
0x00000008
Les éléments spécifiés peuvent être liés à un objet IStorage par le biais de 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 changement de nom des éléments. Toutefois, ceux qui doivent avoir cet attribut doivent être définis.
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 dépôt.
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 supposé être une opération lente. Les applications doivent éviter d’accéder aux éléments signalés par 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’il est supposé être particulièrement lent, 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 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 apparaissent 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 de dossiers, cela signifie que les 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 du système de fichiers Win32.
SFGAO_HIDDEN
0x00080000
l’élément est masqué et ne doit pas être affiché à moins que l’option afficher les fichiers et les dossiers masqués ne soit activée dans le dossier Paramètres.
SFGAO_DISPLAYATTRMASK
0x000FC000
Ne pas utiliser.
SFGAO_NONENUMERATED
0x00100000
Les éléments sont des éléments non énumérés et doivent être masqués. Ils ne sont pas retournés via 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 en question.
SFGAO_CANMONIKER
Non pris en charge.
SFGAO_HASSTORAGE
Non pris en charge.
SFGAO_STREAM
0x00400000
Indique que l’élément est associé à un flux. 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 avec SFGAO_STORAGE ou SFGAO_STREAM.
SFGAO_VALIDATE
0x01000000
Lorsqu’il est spécifié en tant qu’entrée, SFGAO_VALIDATE indique au dossier de valider que les éléments contenus dans un dossier ou un tableau d’éléments d’interpréteur de commandes 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].
En cas d’utilisation avec le dossier du système de fichiers, SFGAO_VALIDATE indique au dossier de supprimer les propriétés mises en cache récupérées par les clients de IShellFolder2 :: GetDetailsEx qui ont pu être accumulés 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 périphériques 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 du système de fichiers ou contiennent au moins un descendant (enfant, petit-enfant ou version ultérieure) qui est un dossier du 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, par exemple un fichier compressé avec une extension de nom de fichier .zip. Certaines applications peuvent inclure cet indicateur lors du test des é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 qu’il s’agit de fichiers, de répertoires ou de répertoires racine). Les noms analysés des éléments peuvent être supposés être des chemins d’accès de système de fichiers Win32 valides. Il peut s’agir d’un chemin d’accès UNC ou d’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. Normalement, les appelants n’utilisent pas cette valeur.
SFGAO_HASSUBFOLDER
0x80000000
Les dossiers spécifiés comportent des sous-dossiers. L’attribut SFGAO_HASSUBFOLDER est uniquement consultatif et peut être retourné par les implémentations de dossiers Shell même s’ils ne contiennent pas de sous-dossiers. Notez, toutefois, que l’inverse, qui ne retourne pas SFGAO_HASSUBFOLDER, indique définitivement que les objets de dossier n’ont pas de sous-dossiers.
Le retour de SFGAO_HASSUBFOLDER est recommandé chaque fois qu’un certain temps est nécessaire pour déterminer si des sous-dossiers existent. Par exemple, le shell 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, à l’heure actuelle uniquement SFGAO_HASSUBFOLDER. Normalement, les appelants n’utilisent 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 provoquant des calculs lents ou qui manquent de contexte : SFGAO_ISSLOW, SFGAO_READONLY, SFGAO_HASSUBFOLDER et SFGAO_VALIDATE. Normalement, les appelants n’utilisent pas cette valeur.

Spécifications

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

Voir aussi

IShellFolder::GetAttributesOf

IShellFolder ::P arseDisplayName

IShellItemArray :: GetAttributes