IAxWinAmbientDispatchEx 接口
此接口为托管控件实现补充环境属性。
重要
无法在 Windows 运行时中执行的应用程序中使用此类及其成员。
语法
MIDL_INTERFACE("B2D0778B - AC99 - 4c58 - A5C8 - E7724E5316B5") IAxWinAmbientDispatchEx : public IAxWinAmbientDispatch
成员
方法
名称 | 描述 |
---|---|
SetAmbientDispatch | 调用此方法可使用用户定义的接口补充默认环境属性接口。 |
备注
在静态链接到 ATL 并托管 ActiveX 控件(尤其是具有环境属性的 ActiveX 控件)的 ATL 应用程序中,务必要包含此接口。 不包括此接口将生成此断言:“你是否忘记将 LIBID 传递给 CComModule::Init”
此接口由 ATL 的 ActiveX 控件托管对象公开。 此接口派生自 IAxWinAmbientDispatch,IAxWinAmbientDispatchEx
添加了一个方法,允许你用你自己的某个接口来补充 ATL 提供的环境属性接口。
AxHost 将尝试从包含代码的类型库中加载关于 IAxWinAmbientDispatch
和 IAxWinAmbientDispatchEx
的类型信息。
如果你链接到 ATL90.dll,AXHost 将从 DLL 中的类型库加载类型信息。
有关更多详细信息,请参阅使用 ATL AXHost 托管 ActiveX 控件。
要求
该接口的定义有多种形式,如下表所示。
定义类型 | 文件 |
---|---|
IDL | atliface.idl |
类型库 | ATL.dll |
C++ | atliface.h(也包含在 ATLBase.h 中) |
IAxWinAmbientDispatchEx::SetAmbientDispatch
调用此方法可使用用户定义的接口补充默认环境属性接口。
virtual HRESULT STDMETHODCALLTYPE SetAmbientDispatch(IDispatch* pDispatch) = 0;
参数
pDispatch
指向新接口的指针。
返回值
如果成功,则返回 S_OK;否则返回错误 HRESULT。
备注
当使用指向新接口的指针调用 SetAmbientDispatch
时,此新接口将用于调用托管控件要求的任何属性或方法(如果 IAxWinAmbientDispatch 尚未提供这些属性)。