Udostępnij za pośrednictwem

Interfejs IAxWinAmbientDispatchEx

  • Artykuł

Ten interfejs implementuje dodatkowe właściwości otoczenia dla hostowanej kontrolki.

Ważne

Tej klasy i jej składowych nie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows.

Składnia

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

Członkowie

Metody

Nazwa/nazwisko opis
SetAmbientDispatch Ta metoda jest wywoływana w celu uzupełnienia domyślnego interfejsu właściwości otoczenia za pomocą interfejsu zdefiniowanego przez użytkownika.

Uwagi

Uwzględnij ten interfejs w aplikacjach ATL, które są statycznie połączone z kontrolkami ATL i hostują kontrolki ActiveX, zwłaszcza kontrolki ActiveX, które mają właściwości otoczenia. Nieuwzmaganie tego interfejsu spowoduje wygenerowanie tej asercji: "Czy zapomnisz przekazać identyfikator LIBID do CComModule::Init"

Ten interfejs jest udostępniany przez obiekty hostowania kontrolek ActiveX atL. Pochodzi z IAxWinAmbientDispatch, dodaje metodę, IAxWinAmbientDispatchEx która umożliwia uzupełnienie interfejsu właściwości otoczenia dostarczonego przez ATL z jednym z własnych.

AxHost Program podejmie próbę załadowania informacji o typie IAxWinAmbientDispatch i IAxWinAmbientDispatchEx z biblioteki typów zawierającej kod.

Jeśli łączysz się z biblioteką ATL90.dll, axHost załaduje informacje o typie z biblioteki typów w bibliotece DLL.

Aby uzyskać więcej informacji, zobacz Hostowanie kontrolek ActiveX przy użyciu atl AXHost .

Wymagania

Definicja tego interfejsu jest dostępna w wielu formularzach, jak pokazano w poniższej tabeli.

Typ definicji Plik
IDL atliface.idl
Biblioteka typów ATL.dll
C++ atliface.h (również w atLBase.h)

IAxWinAmbientDispatchEx::SetAmbientDispatch

Ta metoda jest wywoływana w celu uzupełnienia domyślnego interfejsu właściwości otoczenia za pomocą interfejsu zdefiniowanego przez użytkownika.

virtual HRESULT STDMETHODCALLTYPE SetAmbientDispatch(IDispatch* pDispatch) = 0;

Parametry

pDispatch
Wskaźnik do nowego interfejsu.

Wartość zwracana

Zwraca S_OK powodzenia lub błąd HRESULT w przypadku niepowodzenia.

Uwagi

W przypadku SetAmbientDispatch wywołania wskaźnika do nowego interfejsu ten nowy interfejs będzie używany do wywoływania wszelkich właściwości lub metod wywoływanych przez hostowaną kontrolkę, jeśli te właściwości nie są jeszcze udostępniane przez interfejs IAxWinAmbientDispatch.

Zobacz też

Interfejs IAxWinAmbientDispatch