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.