Compartir a través de


Enumeración FILETYPEATTRIBUTEFLAGS (shlwapi.h)

Indica constantes FILETYPEATTRIBUTEFLAGS que se usan en el valor EditFlags de una clave del Registro PROGID de asociación de archivos.

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
Valor: 0x00000000
No se han establecido opciones FILETYPEATTRIBUTEFLAGS .
FTA_Exclude
Valor: 0x00000001
Excluye el tipo de archivo.
FTA_Show
Valor: 0x00000002
Muestra tipos de archivo, como carpetas, que no están asociadas a una extensión de nombre de archivo.
FTA_HasExtension
Valor: 0x00000004
Indica que el tipo de archivo tiene una extensión de nombre de archivo.
FTA_NoEdit
Valor: 0x00000008
Prohíbe la edición de las entradas del Registro asociadas a este tipo de archivo, la adición de nuevas entradas y la eliminación o modificación de las entradas existentes.
FTA_NoRemove
Valor: 0x00000010
Prohíbe la eliminación de las entradas del Registro asociadas a este tipo de archivo.
FTA_NoNewVerb
Valor: 0x00000020
Prohíbe la adición de nuevos verbos al tipo de archivo.
FTA_NoEditVerb
Valor: 0x00000040
Prohíbe la modificación o eliminación de verbos canónicos , como abrir e imprimir.
FTA_NoRemoveVerb
Valor: 0x00000080
Prohíbe la eliminación de verbos canónicos como abrir e imprimir.
FTA_NoEditDesc
Valor: 0x00000100
Prohíbe la modificación o eliminación de la descripción del tipo de archivo.
FTA_NoEditIcon
Valor: 0x00000200
Prohíbe la modificación o eliminación del icono asignado al tipo de archivo.
FTA_NoEditDflt
Valor: 0x00000400
Prohíbe la modificación del verbo predeterminado.
FTA_NoEditVerbCmd
Valor: 0x00000800
Prohíbe la modificación de los comandos asociados a verbos.
FTA_NoEditVerbExe
Valor: 0x00001000
Prohíbe la modificación o eliminación de verbos.
FTA_NoDDE
Valor: 0x00002000
Prohíbe la modificación o eliminación de las entradas relacionadas con DDE.
FTA_NoEditMIME
Valor: 0x00008000
Prohíbe la modificación o eliminación del tipo de contenido y las entradas de extensión predeterminadas.
FTA_OpenIsSafe
Valor: 0x00010000
Indica que el verbo abierto del tipo de archivo se puede invocar de forma segura para los archivos descargados. Esta marca solo se aplica a tipos de archivo seguros, como se identifica en AssocIsDangerous. Para mejorar la experiencia del usuario y reducir las solicitudes de usuario innecesarias al descargar y activar elementos, los propietarios de tipos de archivo deben especificar esta marca y las aplicaciones que descargan y activan archivos deben respetar esta marca.
FTA_AlwaysUnsafe
Valor: 0x00020000
Impide que se habilite la casilla Nunca preguntarme . El uso de esta marca significa que FTA_OpenIsSafe no se respeta y AssocIsDangerous siempre devuelve TRUE.
Si el tipo de archivo puede ejecutar código, siempre debe usar esta marca o asegurarse de que los controladores de tipos de archivo mitigan los riesgos, por ejemplo, mediante la generación de avisos de advertencia antes de ejecutar el código.

El usuario puede invalidar este atributo a través del cuadro de diálogo Tipo de archivo .
FTA_NoRecentDocs
Valor: 0x00100000
Prohíbe la adición de miembros de este tipo de archivo a la carpeta Documentos recientes . Además, en Windows 7 y versiones posteriores, prohíbe la adición de miembros de este tipo de archivo a la categoría Automática reciente o frecuente de la lista de accesos directos de una aplicación.

Esta marca no restringe la adición de miembros de este tipo de archivo a una lista de accesos directos personalizada. Tampoco se aplica ninguna restricción al tipo de archivo que se agrega al jump automático Listas de otras aplicaciones en caso de que otras aplicaciones usen este tipo de archivo.
FTA_SafeForElevation
Valor: 0x00200000
Introducido en Windows 8. Marca el esquema de archivo o URI como seguro para usarse desde una aplicación de confianza baja. Los archivos que se originan en Internet o en un contenedor de aplicaciones son ejemplos en los que el archivo se considera que no es de confianza. Los archivos que no son de confianza que contienen código son especialmente peligrosos y se deben aplicar mitigaciones de seguridad adecuadas si una aplicación de plena confianza va a abrir el archivo. Los propietarios de tipos de archivo para formatos de archivo que tienen la capacidad de ejecutar código solo deben especificar esta marca si su programa mitiga las amenazas de elevación de privilegios asociadas al código en ejecución en un nivel de integridad superior. Las mitigaciones incluyen preguntar al usuario antes de ejecutar el código o ejecutar el código con privilegios reducidos.

Al especificar esta marca para un tipo de archivo completo, una aplicación que se ejecuta dentro de un contenedor de aplicaciones puede pasar archivos de este tipo a un programa que se ejecuta en plena confianza. Algunos tipos de archivo se reconocen como inherentemente peligrosos debido a su capacidad de ejecutar código y se bloquearán si no especifica este valor.
FTA_AlwaysUseDirectInvoke
Valor: 0x00400000
Introducido en Windows 8. Garantiza que los verbos del tipo de archivo se invocan con un URI en lugar de una versión descargada del archivo. Use esta marca solo si ha registrado el verbo del tipo de archivo para admitir DirectInvoke a través del registro SupportedProtocols o UseUrl.

Comentarios

Estas marcas representan los posibles atributos almacenados en el valor EditFlags de un registro de ProgID. Los datos EditFlags son una sola REG_DWORD.

En el ejemplo siguiente se muestran los atributos FTA_NoRemove (0x00000010) y FTA_NoNewVerb (0x00000020) asignados al tipo de archivo .myp.

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

Las API como IQueryAssociations::GetData pueden recuperar los datos editFlags. Compare los equivalentes numéricos de estas marcas FILETYPEATTRIBUTEFLAGS con respecto al valor recuperado para determinar qué marcas se establecen.

En el ejemplo siguiente se muestra el uso de IQueryAssociations::GetData para determinar si se establecen esos valores.

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();
}

Para establecer un atributo EditFlags, puede usar las funciones RegSetValueEx o SHSetValue . En primer lugar, use IQueryAssociations::GetData para recuperar el conjunto actual de atributos tal como se muestra en el ejemplo anterior, agregue el FILETYPEATTRIBUTEFLAGS deseado a ese valor y, a continuación, vuelva a escribir ese valor en el Registro mediante una de las dos funciones de conjunto.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP, Windows 2000 Professional, Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Encabezado shlwapi.h