FILETYPEATTRIBUTEFLAGS, énumération (shlwapi.h)

Indique les constantes FILETYPEATTRIBUTEFLAGS utilisées dans la valeur EditFlags d’une clé de Registre PROGID d’association de fichiers.

Syntaxe

typedef enum {
  FTA_None = 0x00000000,
  FTA_Exclude = 0x00000001,
  FTA_Show = 0x00000002,
  FTA_HasExtension = 0x00000004,
  FTA_NoEdit = 0x00000008,
  FTA_NoRemove = 0x00000010,
  FTA_NoNewVerb = 0x00000020,
  FTA_NoEditVerb = 0x00000040,
  FTA_NoRemoveVerb = 0x00000080,
  FTA_NoEditDesc = 0x00000100,
  FTA_NoEditIcon = 0x00000200,
  FTA_NoEditDflt = 0x00000400,
  FTA_NoEditVerbCmd = 0x00000800,
  FTA_NoEditVerbExe = 0x00001000,
  FTA_NoDDE = 0x00002000,
  FTA_NoEditMIME = 0x00008000,
  FTA_OpenIsSafe = 0x00010000,
  FTA_AlwaysUnsafe = 0x00020000,
  FTA_NoRecentDocs = 0x00100000,
  FTA_SafeForElevation = 0x00200000,
  FTA_AlwaysUseDirectInvoke = 0x00400000
} FILETYPEATTRIBUTEFLAGS;

Constants


`FTA_None` Valeur : 0x00000000 Aucune option FILETYPEATTRIBUTEFLAGS définie.
`FTA_Exclude` Valeur : 0x00000001 Exclut le type de fichier.
`FTA_Show` Valeur : 0x00000002 Affiche les types de fichiers, tels que les dossiers, qui ne sont pas associés à une extension de nom de fichier.
`FTA_HasExtension` Valeur : 0x00000004 Indique que le type de fichier a une extension de nom de fichier.
`FTA_NoEdit` Valeur : 0x00000008 Interdit la modification des entrées de Registre associées à ce type de fichier, l’ajout de nouvelles entrées et la suppression ou la modification d’entrées existantes.
`FTA_NoRemove` Valeur : 0x00000010 Interdit la suppression des entrées de Registre associées à ce type de fichier.
`FTA_NoNewVerb` Valeur : 0x00000020 Interdit l’ajout de nouveaux verbes au type de fichier.
`FTA_NoEditVerb` Valeur : 0x00000040 Interdit la modification ou la suppression de verbes canoniques tels que l’ouverture et l’impression.
`FTA_NoRemoveVerb` Valeur : 0x00000080 Interdit la suppression de verbes canoniques tels que l’ouverture et l’impression.
`FTA_NoEditDesc` Valeur : 0x00000100 Interdit la modification ou la suppression de la description du type de fichier.
`FTA_NoEditIcon` Valeur : 0x00000200 Interdit la modification ou la suppression de l’icône affectée au type de fichier.
`FTA_NoEditDflt` Valeur : 0x00000400 Interdit la modification du verbe par défaut.
`FTA_NoEditVerbCmd` Valeur : 0x00000800 Interdit la modification des commandes associées aux verbes .
`FTA_NoEditVerbExe` Valeur : 0x00001000 Interdit la modification ou la suppression de verbes.
`FTA_NoDDE` Valeur : 0x00002000 Interdit la modification ou la suppression des entrées liées à DDE.
`FTA_NoEditMIME` Valeur : 0x00008000 Interdit la modification ou la suppression du type de contenu et des entrées d’extension par défaut.
`FTA_OpenIsSafe` Valeur : 0x00010000 Indique que le verbe ouvert du type de fichier peut être appelé en toute sécurité pour les fichiers téléchargés. Cet indicateur s’applique uniquement aux types de fichiers sécurisés, comme identifié par AssocIsDangerous. Pour améliorer l’expérience utilisateur et réduire les invites d’utilisateur inutiles lors du téléchargement et de l’activation d’éléments, les propriétaires de types de fichiers doivent spécifier cet indicateur et les applications qui téléchargent et activent des fichiers doivent respecter cet indicateur.
`FTA_AlwaysUnsafe` Valeur : 0x00020000 Empêche la case à cocher Ne jamais me demander d’être activé. L’utilisation de cet indicateur signifie que FTA_OpenIsSafe n’est pas respecté et AssocIsDangerous retourne toujours TRUE. Si votre type de fichier peut exécuter du code, vous devez toujours utiliser cet indicateur ou vous assurer que les gestionnaires de types de fichiers atténuent les risques, par exemple en produisant des invites d’avertissement avant d’exécuter le code. L’utilisateur peut remplacer cet attribut par le biais de la boîte de dialogue Type de fichier .
`FTA_NoRecentDocs` Valeur : 0x00100000 Interdit l’ajout de membres de ce type de fichier au dossier Documents récents . En outre, dans Windows 7 et versions ultérieures, interdit l’ajout de membres de ce type de fichier à la catégorie récente ou fréquente automatique d’une liste de raccourcis d’une application. Cet indicateur n’empêche pas les membres de ce type de fichier d’être ajoutés à une liste de raccourcis personnalisée. Il n’impose également aucune restriction sur le type de fichier ajouté aux listes de raccourcis automatiques d’autres applications dans le cas où d’autres applications utilisent ce type de fichier.
`FTA_SafeForElevation` Valeur : 0x00200000 Introduit dans Windows 8. Marque le schéma de fichier ou d’URI comme sécurisé à utiliser à partir d’une application à faible niveau de fiabilité. Les fichiers provenant d’Internet ou d’un conteneur d’application sont des exemples où le fichier est considéré comme non approuvé. Les fichiers non approuvés qui contiennent du code sont particulièrement dangereux et les atténuations de sécurité appropriées doivent être appliquées si le fichier doit être ouvert par une application de confiance totale. Les propriétaires de types de fichiers pour les formats de fichiers qui ont la possibilité d’exécuter du code doivent spécifier cet indicateur uniquement si leur programme atténue les menaces d’élévation de privilèges associées à l’exécution du code à un niveau d’intégrité supérieur. Les atténuations incluent l’invite de l’utilisateur avant l’exécution du code ou l’exécution du code avec des privilèges réduits. En spécifiant cet indicateur pour un type de fichier entier, une application s’exécutant dans un conteneur d’application peut transmettre des fichiers de ce type à un programme s’exécutant en toute confiance. Certains types de fichiers sont reconnus comme dangereux par nature en raison de leur capacité à exécuter du code et seront bloqués si vous ne spécifiez pas cette valeur.
`FTA_AlwaysUseDirectInvoke` Valeur : 0x00400000 Introduit dans Windows 8. Garantit que les verbes du type de fichier sont appelés avec un URI au lieu d’une version téléchargée du fichier. Utilisez cet indicateur uniquement si vous avez inscrit le verbe du type de fichier pour prendre en charge DirectInvoke via l’inscription SupportedProtocols ou UseUrl.

Remarques

Ces indicateurs représentent les attributs possibles stockés dans la valeur EditFlags d’une inscription ProgID. Les données EditFlags sont une seule REG_DWORD.

L’exemple suivant montre les attributs FTA_NoRemove (0x00000010 ) et FTA_NoNewVerb (0x00000020 ) affectés au type de fichier .myp.

HKEY_CLASSES_ROOT
   .myp
      (Default) = MyProgram.1
   MyProgram.1
      (Default) = MyProgram Application
      EditFlags = 0x00000030

Les API telles que IQueryAssociations ::GetData peuvent récupérer les données EditFlags. Comparez les équivalents numériques de ces indicateurs FILETYPEATTRIBUTEFLAGS par rapport à cette valeur récupérée pour déterminer quels indicateurs sont définis.

L’exemple suivant illustre l’utilisation d’IQueryAssociations ::GetData pour déterminer si ces valeurs sont définies.

IQueryAssociations *passoc;

HRESULT hr = AssocCreate(CLSID_QueryAssociations, IID_PPV_ARGS(&passoc));
if (SUCCEEDED(hr))
{
    hr = passoc->Init(NULL, pszType, NULL, NULL);
    if (SUCCEEDED(hr))
    {
        DWORD dwEditFlags;
        ULONG cb = sizeof(dwEditFlags);
        
        hr = passoc->GetData(NULL, ASSOCDATA_EDITFLAGS, NULL, &dwEditFlags, &cb);
        if (SUCCEEDED(hr))
        {
            if (dwEditFlags & 0x00000010) // FTA_NoRemove
            {
                // ...
            }    
            if (dwEditFlags & 0x00000020)  // FTA_NoNewVerb
            {
                // ...
            }
        }
    }
    passoc->Release();
}

Pour définir un attribut EditFlags, vous pouvez utiliser les fonctions RegSetValueEx ou SHSetValue . Tout d’abord, utilisez IQueryAssociations ::GetData pour récupérer l’ensemble actuel d’attributs, comme illustré dans l’exemple ci-dessus, ajoutez le FILETYPEATTRIBUTEFLAGS souhaité à cette valeur, puis réécrivez cette valeur dans le Registre à l’aide de l’une des deux fonctions set.

Spécifications

Requirement	Valeur
Client minimum requis	Windows XP, Windows 2000 Professionnel, Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Header	shlwapi.h

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-11-26