共用方式為

IAxWinAmbientDispatchEx 介面

  • 發行項

這個介面會實作裝載控制項的補充環境屬性。

重要

這個類別及其成員不能用於在Windows 執行階段中執行的應用程式。

語法

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

成員

方法

名稱 描述
SetAmbientDispatch 呼叫此方法以補充預設環境屬性介面與使用者定義介面。

備註

在靜態連結至 ATL 和主控 ActiveX 控制項的 ATL 應用程式中包含此介面，尤其是具有環境屬性的 ActiveX 控制項。 不包含此介面會產生此判斷提示：「您是否忘記將 LIBID 傳遞至 CComModule：：Init」

此介面是由 ATL 的 ActiveX 控制項主控物件公開。 衍生自 IAxWinAmbientDispatch 的方法， IAxWinAmbientDispatchEx 可讓您將 ATL 所提供的環境屬性介面補充為您自己的方法。

AxHost會嘗試從包含程式碼的類型程式庫載入 和 IAxWinAmbientDispatchEx 的類型資訊 IAxWinAmbientDispatch 。

如果您要連結至 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 介面