IADsExtension-Schnittstelle (iads.h)
Die IADsExtension-Schnittstelle bildet die Grundlage des ADSI-Anwendungserweiterungsmodells. Es ermöglicht einem unabhängigen Softwarehersteller (INDEPENDENT Software Vendor, ISV), einem vorhandenen ADSI-Objekt anwendungsspezifische Verhaltensweisen wie Methoden oder Funktionen hinzuzufügen. Mehrere Anbieter können die Features desselben Objekts unabhängig erweitern, um ähnliche, aber nicht verwandte Vorgänge auszuführen.
Das Erweiterungsmodell basiert auf dem Aggregationsmodell in COM. Ein Aggregator oder äußeres Objekt kann seiner Basis von Methoden, denen eines Aggregatobjekts oder eines inneren Objekts hinzugefügt werden. Ein ADSI-Erweiterungsobjekt, das die IADsExtension-Schnittstelle implementiert, ist ein Aggregatobjekt, während ein ADSI-Anbieter ein Aggregator ist.
- Die Erweiterungskomponente erfordert eine Initialisierungsbenachrichtigung, wie von dwCode in der Operate-Methode definiert. In diesem Fall muss ein Erweiterungsclient die Operate-Methode aufrufen. Die anderen beiden Methoden, nämlich PrivateInvoke und PrivateGetIDsOfNames, geben normalerweise E_NOTIMPL im HRESULT-Wert zurück.
- Die Erweiterungskomponente unterstützt jede Dual- oder Dispatchschnittstelle. In diesem Fall muss ein Erweiterungsclient die Methoden PrivateGetIDsOfNames oder PrivateInvoke aufrufen. Operate ignoriert in der Regel die Daten und gibt E_NOTIMPL im HRESULT-Wert zurück.
Vererbung
Die IADsExtension-Schnittstelle erbt von der IUnknown-Schnittstelle . IADsExtension verfügt auch über folgende Membertypen:
Methoden
Die IADsExtension-Schnittstelle verfügt über diese Methoden.
| IADsExtension::Operate Interpretiert den Steuerelementcode und die Eingabeparameter gemäß den Spezifikationen des Anbieters. |
| IADsExtension::P rivateGetIDsOfNames Die IADsExtension::P rivateGetIDsOfNames-Methode wird vom Aggregator ADSI aufgerufen, nachdem ADSI ermittelt hat, dass die Erweiterung zur Unterstützung einer Dual- oder Dispatchschnittstelle verwendet wird. Die -Methode kann die Typdaten verwenden, um DISPID mithilfe von IDispatch::GetIDsOfNames abzurufen. |
| IADsExtension::P rivateInvoke Die IADsExtension::P rivateInvoke-Methode wird normalerweise von ADSI nach der IADsExtension::P rivateGetIDsOfNames-Methode aufgerufen. Diese Methode kann entweder über eine benutzerdefinierte Implementierung verfügen oder den Vorgang an die IDispatch::D ispInvoke-Methode delegieren. |
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | iads.h |