This documentation is archived and is not being maintained.

IAxWinAmbientDispatchEx Interface

This interface implements supplemental ambient properties for a hosted control.

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


This interface is exposed by ATL's ActiveX control hosting objects. Derived from IAxWinAmbientDispatch, IAxWinAmbientDispatchEx adds a method that allows you to supplement the ambient property interface provided by ATL with one of your own.

AXHost will try to load type information about IAxWinAmbientDispatch and IAxWinAmbientDispatchEx from the type library that contains the code.

If you are linking to ATL71.dll, AXHost will load the type information from the type library in the DLL.

If you are linking the code into the project, the IDL file for the project should reference IAxWinAmbientDispatch and IAxWinAmbientDispatchEx in order to use them correctly. To make the reference, edit the project IDL file and add the following line after the other imports:

import "atliface.idl"

and the following line inside the library block:

interface IAxWinAmbientDispatchEx;

See Hosting ActiveX Controls Using ATL AXHost for more details.


The definition of this interface is available in a number of forms, as shown in the following table.

Definition Type File
IDL atliface.idl
Type Library ATL.dll
C++ atliface.h (also included in ATLBase.h)

See Also

Interface Members | IAxWinAmbientDispatch