Интерфейс IAxWinAmbientDispatchEx
Этот интерфейс реализует дополнительные свойства окружающей среды для размещенного элемента управления.
Внимание
Этот класс и его члены нельзя использовать в приложениях, выполняемых в среде выполнения Windows.
Синтаксис
MIDL_INTERFACE("B2D0778B - AC99 - 4c58 - A5C8 - E7724E5316B5") IAxWinAmbientDispatchEx : public IAxWinAmbientDispatch
Участники
Методы
| Имя | Описание |
|---|---|
| SetAmbientDispatch | Этот метод вызывается для дополнения интерфейса внешнего свойства по умолчанию с пользовательским интерфейсом. |
Замечания
Включите этот интерфейс в приложения ATL, которые статически связаны с ATL и узлами ActiveX, особенно с элементами ActiveX с внешними свойствами. Не включая этот интерфейс создаст это утверждение: "Вы забыли передать LIBID в CComModule::Init"
Этот интерфейс предоставляется объектами управления ActiveX atL. Производный от IAxWinAmbientDispatch, добавляет метод, который позволяет дополнить интерфейс внешнего свойства, IAxWinAmbientDispatchEx предоставляемый ATL одним из ваших собственных.
AxHost попытается загрузить сведения о типе и IAxWinAmbientDispatch IAxWinAmbientDispatchEx из библиотеки типов, содержащей код.
Если вы связываетесь с ATL90.dll, AXHost загружает сведения о типе из библиотеки типов в библиотеке dll.
Дополнительные сведения см. в разделе "Размещение элементов ActiveX Controls с помощью ATL AXHost ".
Требования
Определение этого интерфейса доступно в нескольких формах, как показано в следующей таблице.
| Тип определения | Файлы |
|---|---|
| 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.