IDirectoryObject-Schnittstelle (iads.h)
Die IDirectoryObject-Schnittstelle ist eine NICHT-Automation-COM-Schnittstelle, die Clients direkten Zugriff auf Verzeichnisdienstobjekte bietet. Die Schnittstelle ermöglicht den Zugriff über ein direktes Over-the-Wire-Protokoll und nicht über den ADSI-Attributcache. Die Verwendung des Over-the-Wire-Protokolls optimiert die Leistung. Mit IDirectoryObject kann ein Client eine beliebige Anzahl von Objektattributen mit einem Methodenaufruf abrufen oder festlegen. Im Gegensatz zu den entsprechenden Automation-Methoden, die im Batch aufgerufen werden, werden diejenigen von IDirectoryObject ausgeführt, wenn sie aufgerufen werden. IDirectoryObject führt keine Attributzwischenspeicherung durch.
Nicht-Automation-Clients können die Methoden von IDirectoryObject aufrufen, um die Leistung zu optimieren und native Verzeichnisdienstschnittstellen zu nutzen. Automation-Clients können IDirectoryObject nicht verwenden. Stattdessen sollten sie die IADs-Schnittstelle verwenden.
Von den vom ADSI-System bereitgestellten Anbietern unterstützt nur der LDAP-Anbieter diese Schnittstelle.
Vererbung
Die IDirectoryObject-Schnittstelle erbt von der IUnknown-Schnittstelle . IDirectoryObject verfügt auch über die folgenden Membertypen:
Methoden
Die IDirectoryObject-Schnittstelle verfügt über diese Methoden.
| IDirectoryObject::CreateDSObject Erstellt ein untergeordnetes Element des aktuellen Verzeichnisdienstobjekts. |
| IDirectoryObject::D eleteDSObject Löscht ein Blattobjekt in einer Verzeichnisstruktur. |
| IDirectoryObject::GetObjectAttributes Ruft mindestens ein angegebenes Attribut des Verzeichnisdienstobjekts ab. |
| IDirectoryObject::GetObjectInformation Die IDirectoryObject::GetObjectInformation-Methode ruft einen Zeiger auf eine ADS_OBJECT_INFO-Struktur ab, die Daten zur Identität und zum Speicherort eines Verzeichnisdienstobjekts enthält. |
| IDirectoryObject::SetObjectAttributes Die IDirectoryObject::SetObjectAttributes-Methode ändert Daten in einem oder mehreren angegebenen Objektattributen, die in der ADS_ATTR_INFO-Struktur definiert sind. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | iads.h |