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.