Partager via


IAxWinAmbientDispatchEx, interface

Cette interface implémente des propriétés ambiantes supplémentaires pour un contrôle hébergé.

Important

Cette classe et ses membres ne peuvent pas être utilisés dans les applications qui s’exécutent dans Windows Runtime.

Syntaxe

MIDL_INTERFACE("B2D0778B - AC99 - 4c58 - A5C8 - E7724E5316B5") IAxWinAmbientDispatchEx : public IAxWinAmbientDispatch

Membres

Méthodes

Nom Description
SetAmbientDispatch Cette méthode est appelée pour compléter l’interface de propriété ambiante par défaut avec une interface définie par l’utilisateur.

Notes

Incluez cette interface dans les applications ATL qui sont liées statiquement à ATL et hébergent des contrôles ActiveX, en particulier des contrôles ActiveX qui ont des propriétés ambiantes. L’inclusion de cette interface génère cette assertion : « Vous avez oublié de passer le LIBID à CComModule ::Init »

Cette interface est exposée par les objets d’hébergement de contrôle ActiveX d’ATL. Dérivée de IAxWinAmbientDispatch, IAxWinAmbientDispatchEx ajoute une méthode qui vous permet de compléter l’interface de propriété ambiante fournie par ATL avec l’un de vos propres.

AxHost essaiera de charger des informations de type sur IAxWinAmbientDispatch et IAxWinAmbientDispatchEx à partir de la bibliothèque de types qui contient le code.

Si vous établissez un lien vers ATL90.dll, AXHost charge les informations de type de la bibliothèque de types dans la DLL.

Pour plus d’informations, consultez Hébergement de contrôles ActiveX à l’aide d’ATL AXHost .

Spécifications

La définition de cette interface est disponible dans un certain nombre de formulaires, comme indiqué dans le tableau suivant.

Type de définition File
IDL atliface.idl
Bibliothèque de types ATL.dll
C++ atliface.h (également inclus dans ATLBase.h)

IAxWinAmbientDispatchEx ::SetAmbientDispatch

Cette méthode est appelée pour compléter l’interface de propriété ambiante par défaut avec une interface définie par l’utilisateur.

virtual HRESULT STDMETHODCALLTYPE SetAmbientDispatch(IDispatch* pDispatch) = 0;

Paramètres

pDispatch
Pointeur vers la nouvelle interface.

Valeur de retour

Retourne S_OK en cas de réussite ou une erreur HRESULT en cas d’échec.

Notes

Lorsqu’elle SetAmbientDispatch est appelée avec un pointeur vers une nouvelle interface, cette nouvelle interface est utilisée pour appeler toutes les propriétés ou méthodes demandées par le contrôle hébergé, si ces propriétés ne sont pas déjà fournies par IAxWinAmbientDispatch.

Voir aussi

IAxWinAmbientDispatch, interface