Поделиться через

Интерфейс 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 попытается загрузить сведения о типе и IAxWinAmbientDispatchIAxWinAmbientDispatchEx из библиотеки типов, содержащей код.

Если вы связываетесь с 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.

См. также

Интерфейс IAxWinAmbientDispatch