Interfaz IQueryAssociations (shlwapi.h)

  • Artículo

Expone métodos que simplifican el proceso de recuperación de información almacenada en el registro en asociación con la definición de un tipo de archivo o protocolo y su asociación con una aplicación.

Herencia

La interfaz IQueryAssociations hereda de la interfaz IUnknown . IQueryAssociations también tiene estos tipos de miembros:

Métodos

La interfaz IQueryAssociations tiene estos métodos.

 
IQueryAssociations::GetData

Busca y recupera datos binarios relacionados con la asociación de archivos o protocolos del registro.
IQueryAssociations::GetEnum

Este método no se implementa. (IQueryAssociations.GetEnum)
IQueryAssociations::GetKey

Busca y recupera una clave relacionada con la asociación de archivos o protocolos del Registro.
IQueryAssociations::GetString

Busca y recupera una cadena relacionada con la asociación de archivos o protocolos del registro. (IQueryAssociations.GetString)
IQueryAssociations::Init

Inicializa la interfaz IQueryAssociations y establece la clave raíz en el ProgID adecuado.

Comentarios

Cuándo implementar

Esta interfaz se expone mediante shell o por extensiones de espacio de nombres para simplificar el control de asociaciones de archivos y protocolos. No debe implementar esta interfaz.

Cuándo usar

Use esta interfaz si necesita información del registro relacionada con asociaciones de archivo o protocolo. Por ejemplo, puede usar esta interfaz para recuperar información asociada a una extensión de nombre de archivo, como la cadena de comando de uno de sus verbos.

No se requiere una ruta de acceso completa del Registro o un valor HKEY. En su lugar, puede recuperar información basada en criterios como la extensión de nombre de archivo o el nombre ejecutable. Para obtener una explicación de las asociaciones de archivos, vea Tipos de archivo.

También puede recuperar el nombre de una aplicación mediante esta interfaz. Use el método IQueryAssociations::GetString. Establezca el parámetro stren ASSOCSTR_FRIENDLYAPPNAME.

Para usar esta interfaz, primero debe recuperar un puntero a ella. Normalmente, se recupera un puntero QueryInterface mediante una llamada al método IShellFolder::GetUIObjectOf de un objeto Shell. También puede recuperar un puntero de interfaz llamando a AssocCreate (establezca clsid en CLSID_QueryAssociations). Inicialice la interfaz con IQueryAssociations::Init. Este método establece la clave raíz que se usará al llamar a cualquiera de los tres métodos restantes para recuperar información del Registro. Solo se verán debajo de la clave raíz. Debe liberar la interfaz cuando ya no la necesite.

La interfaz IQueryAssociations es útil si necesita consultar repetidamente el registro para obtener información. Una vez inicializada la interfaz, la sobrecarga de llamar a los distintos métodos es relativamente pequeña. También hay varias funciones relacionadas, enumeradas en la sección Ver también, que permiten recuperar la misma información del registro con una sola llamada de función. Aunque son más fáciles de usar, provocan la sobrecarga de crear e inicializar IQueryAssociations cada vez que se les llama. Por este motivo, son más adecuados para un solo uso.

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]
Plataforma de destino Windows
Encabezado shlwapi.h

Consulte también

AssocQueryKey

AssocQueryString

AssocQueryStringByKey