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.