Interfaz IAxWinAmbientDispatchEx

Esta interfaz implementa propiedades de ambiente complementarias para un control hospedado.

Importante

Esta clase y sus miembros no se pueden usar en las aplicaciones que se ejecutan en Windows Runtime.

Sintaxis

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

Miembros

Métodos

Nombre	Descripción
SetAmbientDispatch	Se llama a este método para complementar la interfaz de propiedad de ambiente predeterminada con una interfaz definida por el usuario.

Comentarios

Incluya esta interfaz en las aplicaciones ATL que están vinculadas estáticamente a ATL y hospedan controles ActiveX, especialmente controles ActiveX que tienen propiedades ambientales. Si no se incluye esta interfaz, se generará esta aserción: "Olvidó pasar el LIBID a CComModule::Init"

Esta interfaz se expone mediante los objetos de hospedaje de controles ActiveX de ATL. Derivado de IAxWinAmbientDispatch, IAxWinAmbientDispatchEx agrega un método que le permite complementar la interfaz de propiedad ambiente proporcionada por ATL con uno de los suyos.

AxHost intentará cargar información de tipos sobre IAxWinAmbientDispatch y IAxWinAmbientDispatchEx desde la biblioteca de tipos que contiene el código.

Si va a establecer una vinculación con ATL90.dll, AXHost cargará la información de tipos de la biblioteca de tipos en el archivo DLL.

Consulte Hospedar controles ActiveX mediante ATL AXHost para más información.

Requisitos

La definición de esta interfaz está disponible en varias formas, como se muestra en la tabla siguiente.

Tipo de definición	Archivo
IDL	atliface.idl
Biblioteca de tipos	ATL.dll
C++	atliface.h (incluido también en ATLBase.h)

IAxWinAmbientDispatchEx::SetAmbientDispatch

Se llama a este método para complementar la interfaz de propiedad de ambiente predeterminada con una interfaz definida por el usuario.

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

Parámetros

pDispatch
Puntero a la nueva interfaz .

Valor devuelto

Devuelve S_OK si es correcto o un error HRESULT en caso de error.

Comentarios

Cuando se llama a SetAmbientDispatch con un puntero a una nueva interfaz, esta se usará para invocar a las propiedades o métodos solicitados por el control hospedado, si IAxWinAmbientDispatch no proporciona esas propiedades.

Consulte también

IAxWinAmbientDispatch (interfaz)