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.

Hinweis Geben Sie bei der Implementierung eines Erweiterungsmoduls eine Schnittstelle frei, wenn sie damit fertig ist. Andernfalls kann der Aggregator die Schnittstelle auch dann nicht freigeben, wenn sie nicht mehr benötigt wird.

 

Die IADsExtension-Schnittstelle kann wie folgt verwendet werden:

• 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