Interface IQueryAssociations (shlwapi.h)

Expose des méthodes qui simplifient le processus de récupération des informations stockées dans le Registre en association avec la définition d’un type de fichier ou d’un protocole et son association à une application.

Héritage

L’interface IQueryAssociations hérite de l’interface IUnknown . IQueryAssociations a également les types de membres suivants :

Méthodes

L’interface IQueryAssociations a ces méthodes.

IQueryAssociations ::GetData Recherche et récupère des données binaires liées à l’association de fichiers ou de protocoles à partir du Registre.
IQueryAssociations ::GetEnum Cette méthode n’est pas implémentée. (IQueryAssociations.GetEnum)
IQueryAssociations ::GetKey Recherche et récupère une clé liée à l’association de fichier ou de protocole à partir du Registre.
IQueryAssociations ::GetString Recherche et récupère une chaîne liée à l’association de fichier ou de protocole à partir du Registre. (IQueryAssociations.GetString)
IQueryAssociations ::Init Initialise l’interface IQueryAssociations et définit la clé racine sur le ProgID approprié.

Remarques

Quand implémenter

Cette interface est exposée par l’interpréteur de commandes ou par les extensions d’espace de noms pour simplifier la gestion des associations de fichiers et de protocoles. Vous ne devez pas implémenter cette interface.

Quand utiliser

Utilisez cette interface si vous avez besoin d’informations du registre relatives aux associations de fichiers ou de protocole. Par exemple, vous pouvez utiliser cette interface pour récupérer des informations associées à une extension de nom de fichier, comme la chaîne de commande de l’un de ses verbes.

Un chemin d’accès de Registre complet ou une valeur HKEY n’est pas nécessaire. Au lieu de cela, vous pouvez récupérer des informations basées sur des critères tels que l’extension de nom de fichier ou le nom de l’exécutable. Pour plus d’informations sur les associations de fichiers, consultez Types de fichiers.

Vous pouvez également récupérer le nom d’une application à l’aide de cette interface. Utilisez la méthode IQueryAssociations ::GetString. Définissez le paramètre str sur ASSOCSTR_FRIENDLYAPPNAME.

Pour utiliser cette interface, vous devez d’abord récupérer un pointeur vers celle-ci. En règle générale, vous récupérez un pointeur QueryInterface en appelant la méthode IShellFolder ::GetUIObjectOf d’un objet Shell. Vous pouvez également récupérer un pointeur d’interface en appelant AssocCreate (définissez clsid sur CLSID_QueryAssociations). Initialisez l’interface avec IQueryAssociations ::Init. Cette méthode définit la clé racine qui sera utilisée lorsque vous appelez l’une des trois méthodes restantes pour récupérer des informations à partir du Registre. Ils ne s’affichent qu’en dessous de la clé racine. Vous devez libérer l’interface lorsque vous n’en avez plus besoin.

L’interface IQueryAssociations est utile si vous devez interroger à plusieurs reprises le Registre pour obtenir des informations. Une fois l’interface initialisée, la surcharge liée à l’appel des différentes méthodes est relativement faible. Il existe également plusieurs fonctions associées, répertoriées dans la section Voir aussi, qui vous permettent de récupérer les mêmes informations à partir du Registre avec un seul appel de fonction. Bien qu’elles soient plus simples à utiliser, elles entraînent une surcharge liée à la création et à l’initialisation d’IQueryAssociations chaque fois qu’elles sont appelées. Pour cette raison, ils sont mieux adaptés à une utilisation unique.

Configuration requise

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

Voir aussi

AssocQueryKey

AssocQueryString

AssocQueryStringByKey