Partager via


QueryInterface

Bien qu'il y ait des mécanismes par lesquels un objet peut exprimer la fonctionnalité il fournisse statiquement (avant qu'il est instancié), le mécanisme COM de concept fondamental est d'utiliser la méthode d' IUnknown appelée QueryInterface.

Chaque interface est dérivée d' IUnknown, pour chaque interface a une implémentation d' QueryInterface.Indépendamment de l'implémentation, cette méthode recherche un objet à l'aide de l'IID de l'interface à laquelle l'appelant veut un pointeur.Si les prend en charge l'objet d'interface qui, QueryInterface extrait un pointeur vers l'interface, tout en également appelant AddRef.Sinon, il retourne un code d'erreur d' E_NOINTERFACE .

Notez que vous devez vous conformer aux règles de décompte de références à tout moment.Si vous appelez Release sur un pointeur d'interface pour décrémenter le décompte de références à zéro, vous ne devez pas utiliser ce pointeur de nouveau.Occasionnellement vous devrez peut-être obtenir une référence faible à un objet (autrement dit, vous pouvez souhaiter obtenir un pointeur vers une de ses interfaces sans incrémenter le décompte de références), mais il n'est pas acceptable d'effectuer cette opération en appelant QueryInterface suivi de Release.Le pointeur obtenu de cette façon n'est pas valide et ne doit pas être utilisé.Elle devient plus facilement affiche lorsque _ATL_DEBUG_INTERFACES est défini, donc définir cette macro est un moyen d'identifier les bogues de décompte de références.

Voir aussi

Référence

Introduction à COM

QueryInterface: Navigating in an Object