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 尚未提供這些屬性，則這個新介面將用來叫用裝載控件要求的任何屬性或方法。