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 |
---|---|
|
Les éléments spécifiés peuvent être copiés. |
|
Les éléments spécifiés peuvent être déplacés. |
|
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. |
|
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. |
|
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. |
|
Les éléments spécifiés peuvent être supprimés. |
|
Les éléments spécifiés ont des feuilles de propriétés. |
|
Les éléments spécifiés sont des cibles de suppression. |
|
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. |
|
Windows 7 et versions ultérieures. Les éléments spécifiés sont des éléments système. |
|
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. |
|
Les éléments spécifiés sont affichés comme grisés et non disponibles pour l’utilisateur. |
|
Les éléments spécifiés sont des raccourcis. |
|
Les objets spécifiés sont partagés. |
|
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. |
|
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. |
|
Ne pas utiliser. |
|
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 . |
|
Les éléments contiennent un nouveau contenu, tel que défini par l’application particulière. |
|
Non pris en charge. |
|
Non pris en charge. |
|
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 . |
|
Les enfants de cet élément sont accessibles via IStream ou IStorage. Ces enfants sont marqués de SFGAO_STORAGE ou de SFGAO_STREAM. |
|
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. |
|
Les éléments spécifiés se trouvent sur un support amovible ou sont eux-mêmes des appareils amovibles. |
|
Les éléments spécifiés sont compressés. |
|
Les éléments spécifiés peuvent être hébergés à l’intérieur d’un navigateur web ou d’un cadre Windows Explorer. |
|
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). |
|
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. |
|
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. |
|
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. |
|
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. |
|
Cet indicateur est un masque pour les attributs de contenu, actuellement uniquement SFGAO_HASSUBFOLDER. Les appelants n’utilisent normalement pas cette valeur. |
|
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. |
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 |
|
IDL |
|