Duale Schnittstellen (ADSI)

Verwenden Sie COM-Schnittstellen, um auf die Eigenschaften und Methoden für alle ADSI-Objekte des Anbieters zuzugreifen. Eine schreibgeschützte Eigenschaft ist einem Schnittstelleneintrag des Formulars get_<PropertyName>zugeordnet. Eine Lese-/Schreibeigenschaft ist zwei Schnittstelleneinträgen des Formulars get_<PropertyName-> und put_<PropertyName->zugeordnet.

Alle Methoden auf einer COM-Schnittstelle müssen:

• Gibt einen HRESULT-Wert zurück, um Erfolg oder Fehler anzugeben. Der HRESULT- Typs wird in der COM-Spezifikation erläutert.
• Geben Sie bei Aufrufen von QueryInterface-E_NOINTERFACE für nicht implementierte Schnittstellen zurück.
• Gibt E_NOTIMPL für nicht implementierte Methoden für Schnittstellen zurück, die andernfalls implementiert sind.
• Gibt E_ADS_PROPERTY_NOT_SUPPORTED für Schnittstelleneigenschaften zurück, die nicht unterstützt werden.

Um die Kompatibilität mit Automatisierungscontrollern beizubehalten, sollten alle Parameter und Rückgabetypen innerhalb der Teilmenge enthalten sein, die vom Automatisierungs-VARIANT-Datentyp definiert ist. Weitere Informationen finden Sie unter VARIANT und VARIANTARG- im Platform Software Development Kit (SDK).

Ein Anbieter-Active Directory-Objekt kann Schnittstellen verfügbar machen, die andere Datentypen als die in der VARIANT Teilmenge verwenden. Automatisierungscontroller wie Visual Basic können diese Schnittstellen jedoch nicht aufrufen. Die meisten ADSI-Anbieterschnittstellen werden von IDispatch- abgeleitet und können als IDispatch- Schnittstellenzeiger verwendet werden. Die IDirectoryObject, IDirectorySearchund IADsExtension ADSI-Schnittstellen werden jedoch nicht von IDispatch-abgeleitet.