Freigeben über


IAxWinAmbientDispatchEx-Schnittstelle

Diese Schnittstelle implementiert zusätzliche Umgebungseigenschaften für ein gehostetes Steuerelement.

Wichtig

Diese Klasse und ihre Member können nicht in Anwendungen verwendet werden, die in der Windows-Runtime ausgeführt werden.

Syntax

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

Member

Methoden

Name Beschreibung
SetAmbientDispatch Diese Methode wird aufgerufen, um die Standardumgebungseigenschaftsschnittstelle mit einer benutzerdefinierten Schnittstelle zu ergänzen.

Hinweise

Schließen Sie diese Schnittstelle in ATL-Anwendungen ein, die statisch mit ATL verknüpft sind und ActiveX-Steuerelemente hosten, insbesondere ActiveX-Steuerelemente mit Umgebungseigenschaften. Diese Schnittstelle wird nicht eingeschlossen, um diese Assertion zu generieren: "Haben Sie vergessen, die LIBID an CComModule::Init zu übergeben"

Diese Schnittstelle wird durch das Hostobjekt des ActiveX-Steuerelements von ATL verfügbar gemacht. Abgeleitet von IAxWinAmbientDispatch fügt eine Methode hinzu, IAxWinAmbientDispatchEx mit der Sie die Umgebungseigenschaftsschnittstelle ergänzen können, die von ATL mit einem ihrer eigenen bereitgestellt wird.

AxHost versucht, Typinformationen zu IAxWinAmbientDispatch und IAxWinAmbientDispatchEx aus der Typbibliothek zu laden, die den Code enthält.

Wenn Sie eine Verknüpfung mit ATL90.dll herstellen, lädt AXHost die Typinformationen aus der Typbibliothek in der DLL.

Weitere Informationen finden Sie unter Hosten von ActiveX-Steuerelementen mit ATL AXHost .

Anforderungen

Die Definition dieser Schnittstelle ist in einer Reihe von Formularen verfügbar, wie in der folgenden Tabelle dargestellt.

Definitionstyp Datei
IDL atliface.idl
Typbibliothek ATL.dll
C++ atliface.h (auch in ATLBase.h enthalten)

IAxWinAmbientDispatchEx::SetAmbientDispatch

Diese Methode wird aufgerufen, um die Standardumgebungseigenschaftsschnittstelle mit einer benutzerdefinierten Schnittstelle zu ergänzen.

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

Parameter

pDispatch
Zeiger auf die neue Schnittstelle.

Rückgabewert

S_OK bei Erfolg, ein HRESULT-Fehler bei einem Fehlschlag.

Hinweise

Wenn SetAmbientDispatch mit einem Zeiger auf eine neue Schnittstelle aufgerufen wird, wird diese neue Schnittstelle verwendet, um alle Eigenschaften oder Methoden aufzurufen, die vom gehosteten Steuerelement angefordert werden, wenn diese Eigenschaften nicht bereits von IAxWinAmbientDispatch bereitgestellt werden.

Siehe auch

IAxWinAmbientDispatch-Schnittstelle