ÉNUMÉRATION FILETYPEATTRIBUTEFLAGS (shlwapi.h)

  • Article

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

Syntax

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;

Constantes

 
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 fiables, tels qu’identifiés par AssocIsDangerous. Pour améliorer l’expérience utilisateur et réduire les invites inutiles de l’utilisateur 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 l’activation de la zone Ne jamais me demander case activée. L’utilisation de cet indicateur signifie 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 via 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 automatique Récent ou Fréquent de la 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 pas non plus de restriction sur le type de fichier ajouté à l’Listes jump automatique 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 fichier ou le schéma d’URI comme sécurisé à utiliser à partir d’une application à faible niveau de fiabilité. Les fichiers qui proviennent 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 des 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 mesures d’atténuation 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 exécutée 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 intrinsèquement dangereux en raison de leur capacité à exécuter du code et sont 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) attribué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 ces données EditFlags. Comparez les équivalents numériques de ces indicateurs FILETYPEATTRIBUTEFLAGS à cette valeur récupérée pour déterminer quels indicateurs sont définis.

L’exemple suivant illustre l’utilisation de 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 le jeu d’attributs actuel, comme indiqué dans l’exemple ci-dessus, ajoutez le FICHIERTYPEATTRIBUTEFLAGS souhaité à cette valeur, puis réécrivez cette valeur dans le Registre à l’aide de l’une des deux fonctions set.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP, Windows 2000 Professionnel, Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête shlwapi.h