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 尚未提供这些属性）。

另请参阅

IAxWinAmbientDispatch 接口