Interfejs IAxWinAmbientDispatchEx
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
Elementy członkowskie
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 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.