Enumeración ASSOCF

Artículo
06/13/2023

Proporciona información a los métodos de interfaz IQueryAssociations .

Sintaxis

typedef enum  {
    ASSOCF_NONE                  = 0x00000000,  
    ASSOCF_INIT_NOREMAPCLSID     = 0x00000001,  
    ASSOCF_INIT_BYEXENAME        = 0x00000002,  
    ASSOCF_OPEN_BYEXENAME        = 0x00000002,  
    ASSOCF_INIT_DEFAULTTOSTAR    = 0x00000004,  
    ASSOCF_INIT_DEFAULTTOFOLDER  = 0x00000008,  
    ASSOCF_NOUSERSETTINGS        = 0x00000010,  
    ASSOCF_NOTRUNCATE            = 0x00000020,  
    ASSOCF_VERIFY                = 0x00000040,  
    ASSOCF_REMAPRUNDLL           = 0x00000080,  
    ASSOCF_NOFIXUPS              = 0x00000100,  
    ASSOCF_IGNOREBASECLASS       = 0x00000200,  
    ASSOCF_INIT_IGNOREUNKNOWN    = 0x00000400,  
    ASSOCF_INIT_FIXED_PROGID     = 0x00000800,  
    ASSOCF_IS_PROTOCOL           = 0x00001000,  
    ASSOCF_INIT_FOR_FILE         = 0x00002000
} ASSOCF;

Constantes

ASSOCF_NONE

No se establece ninguna de las siguientes opciones.

ASSOCF_INIT_NOREMAPCLSID

Indica a los métodos de interfaz IQueryAssociations que no asignen valores CLSID a valores de ProgID.

ASSOCF_INIT_BYEXENAME

Identifica el valor del parámetro pwszAssoc de IQueryAssociations::Init como nombre de archivo ejecutable. Si no se establece esta marca, la clave raíz se establecerá en el ProgID asociado a la clave .exe en lugar del ProgID del archivo ejecutable.

ASSOCF_OPEN_BYEXENAME

Idéntico a ASSOCF_INIT_BYEXENAME.

ASSOCF_INIT_DEFAULTTOSTAR

Especifica que cuando un método IQueryAssociations no encuentra el valor solicitado en la clave raíz, debe intentar recuperar el valor comparable de la * subclave.

ASSOCF_INIT_DEFAULTTOFOLDER

Especifica que cuando un método IQueryAssociations no encuentra el valor solicitado en la clave raíz, debe intentar recuperar el valor comparable de la subclave Folder .

ASSOCF_NOUSERSETTINGS

Especifica que solo se deben buscar HKEY_CLASSES_ROOT y que HKEY_CURRENT_USER deben omitirse.

ASSOCF_NOTRUNCATE

Especifica que la cadena de retorno no debe truncarse. En su lugar, devuelve un valor de error y el tamaño necesario para la cadena completa.

ASSOCF_VERIFY

Indica a los métodos IQueryAssociations que comprueben que los datos son precisos. Esta configuración permite que los métodos IQueryAssociations lean datos del disco duro del usuario para su comprobación. Por ejemplo, pueden comprobar el nombre descriptivo en el registro en el almacenado en el archivo .exe. Establecer esta marca normalmente reduce la eficacia del método.

ASSOCF_REMAPRUNDLL

Indica a los métodos IQueryAssociations que omitan Rundll.exe y devuelvan información sobre su destino. Normalmente, los métodos IQueryAssociations devuelven información sobre el primer .exe o .dll en una cadena de comandos. Si un comando usa Rundll.exe, al establecer esta marca se indica al método que omita Rundll.exe y devuelva información sobre su destino.

ASSOCF_NOFIXUPS

Indica a los métodos IQueryAssociations que no corrijan errores en el registro, como el nombre descriptivo de una función que no coincida con el que se encuentra en el archivo .exe.

ASSOCF_IGNOREBASECLASS

Especifica que se debe omitir el valor BaseClass.

ASSOCF_INIT_IGNOREUNKNOWN

Introducido en Windows 7. Especifica que se debe omitir el ProgID "Desconocido"; en su lugar, produce un error.

ASSOCF_INIT_FIXED_PROGID

Introducido en Windows 8. Especifica que el ProgID proporcionado debe asignarse con los valores predeterminados del sistema, en lugar de los valores predeterminados del usuario actual.

ASSOCF_IS_PROTOCOL

Introducido en Windows 8. Especifica que el valor es un protocolo y se debe asignar mediante los valores predeterminados del usuario actual.

ASSOCF_INIT_FOR_FILE

Introducido en Windows 8.1. Especifica que progID corresponde a una asociación basada en la extensión de archivo. Use junto con ASSOCF_INIT_FIXED_PROGID.

Requisitos

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

Consulte también

AssocQueryKeyAssocQueryStringAssocQueryStringByKey