Microsoft OLE DB-Anbieter für den Microsoft Active Directory-Dienst
Der ADSI-Anbieter (Active Directory Service Interfaces) ermöglicht es ADO, eine Verbindung mit heterogenen Verzeichnisdiensten über ADSI herzustellen. Dadurch erhalten ADO-Anwendungen schreibgeschützten Zugriff auf die Verzeichnisdienste von Microsoft Windows NT 4.0 und Microsoft Windows 2000 sowie auf alle LDAP-kompatiblen Verzeichnisdienste und Novell-Verzeichnisdienste. ADSI selbst basiert auf einem Anbietermodell, sodass die ADO-Anwendung nahtlos auf ein neues Verzeichnis zugreifen kann, wenn es einen neuen Anbieter gibt, der den Zugang zu diesem Verzeichnis ermöglicht. Für den ADSI-Anbieter sind freies Threading und Unicode aktiviert.
Parameter der Verbindungszeichenfolge
Um eine Verbindung mit diesem Anbieter herzustellen, legen Sie das Argument Provider der Eigenschaft ConnectionString wie folgt fest:
ADSDSOObject
Beim Lesen der Provider-Eigenschaft wird diese Zeichenfolge ebenfalls zurückgegeben.
Typische Verbindungszeichenfolge
Eine typische Verbindungszeichenfolge für diesen Anbieter sieht wie folgt aus:
"Provider=ADSDSOObject;User ID=MyUserID;Password=<password>;"
Die Zeichenfolge besteht aus den folgenden Schlüsselwörtern.
| Schlüsselwort | Beschreibung |
|---|---|
| Anbieter | Gibt den OLE DB-Anbieter für den Active Directory-Dienst an |
| Benutzer-ID | Gibt den Benutzernamen an. Wenn dieses Schlüsselwort nicht angegeben wird, wird die aktuelle Anmeldung verwendet |
| Kennwort | Gibt das Benutzerkennwort an. Wenn dieses Schlüsselwort nicht angegeben wird, wird die aktuelle Anmeldung verwendet. |
Hinweis
Wenn Sie eine Verbindung mit einem Datenquellenanbieter herstellen, der die Windows-Authentifizierung unterstützt, sollten Sie anstelle von Benutzer-ID und Kennwort Trusted_Connection=yes oder Integrated Security = SSPI in der Verbindungszeichenfolge angeben.
Befehlstext
Eine vierteilige Textzeichenfolge wird vom Anbieter in der folgenden Syntax erkannt:
"Root; Filter; Attributes[; Scope]"
| Wert | Beschreibung |
|---|---|
| Root | Gibt das ADsPath-Objekt an, von dem aus die Suche gestartet werden soll (d. h. der Stamm der Suche) |
| Filter | Gibt den Suchfilter im RFC 1960-Format an |
| Attribute | Gibt eine durch Kommas getrennte Liste von Attributen an, die zurückgegeben werden sollen |
| Umfang | Optional. Eine Zeichenfolge, die den Umfang der Suche angibt. Dabei kann es sich um eine der folgenden Methoden handeln: – Base: Nur das Basisobjekt wird durchsucht (Stamm der Suche). – OneLevel: Nur eine Ebene wird durchsucht. – Subtree: Die gesamte Unterstruktur wird durchsucht. |
Beispiel:
"<LDAP://DC=ArcadiaBay,DC=COM>;(objectClass=*);sn, givenName; subtree"
Der Anbieter unterstützt auch SQL SELECT für den Befehlstext. Beispiel:
"SELECT title, telephoneNumber From 'LDAP://DC=Microsoft, DC=COM' WHERE
objectClass='user' AND objectCategory='Person'"
Bemerkungen
Der Anbieter akzeptiert keine gespeicherten Prozeduraufrufe oder einfache Tabellennamen (z. B. ist die Eigenschaft CommandType immer adCmdText). Eine ausführlichere Beschreibung der Befehlstextelemente finden Sie in der Dokumentation zu Active Directory Service Interfaces.
Recordset-Verhalten
In den folgenden Tabellen sind die Features aufgeführt, die in einem Recordset-Objekt verfügbar sind, das mit diesem Anbieter geöffnet wurde. Nur der statische Cursortyp (adOpenStatic) ist verfügbar.
Für weitere Informationen zum Recordset-Verhalten für Ihre Anbieterkonfiguration führen Sie die Supports-Methode aus, und zählen Sie die Properties-Sammlung des Recordset auf, um zu ermitteln, ob anbieterspezifische dynamische Eigenschaften vorhanden sind.
Verfügbarkeit der Standardeigenschaften von ADO-Recordsets:
| Eigenschaft | Verfügbarkeit |
|---|---|
| AbsolutePage | read/write (Lesen/Schreiben) |
| AbsolutePosition | read/write (Lesen/Schreiben) |
| ActiveConnection | schreibgeschützt |
| BOF | schreibgeschützt |
| Textmarke | read/write (Lesen/Schreiben) |
| CacheSize | read/write (Lesen/Schreiben) |
| CursorLocation | Immer adUseServer |
| CursorType | Immer adOpenStatic |
| EditMode | Immer adEditNone |
| EOF | schreibgeschützt |
| Filter | read/write (Lesen/Schreiben) |
| LockType | read/write (Lesen/Schreiben) |
| MarshalOptions | nicht verfügbar |
| MaxRecords | read/write (Lesen/Schreiben) |
| PageCount | schreibgeschützt |
| PageSize | read/write (Lesen/Schreiben) |
| RecordCount | schreibgeschützt |
| Quelle | read/write (Lesen/Schreiben) |
| Zustand | schreibgeschützt |
| Status | schreibgeschützt |
Verfügbarkeit der Standardmethoden von ADO-Recordsets:
| Methode | Verfügbar? |
|---|---|
| AddNew | No |
| Abbrechen | No |
| CancelBatch | No |
| CancelUpdate | No |
| Klonen | Ja |
| Schließen | Ja |
| Löschen | No |
| GetRows | Ja |
| Verschieben | Ja |
| MoveFirst | Ja |
| MoveLast | Ja |
| MoveNext | Ja |
| MovePrevious | Yes |
| NextRecordset | Ja |
| Öffnen | Ja |
| Requery | Ja |
| Resync | Yes |
| Unterstützt | Ja |
| Aktualisieren | No |
| UpdateBatch | No |
Weitere Informationen zu ADSI und den Besonderheiten des Anbieters finden Sie in der Dokumentation zu Active Directory Service Interfaces oder auf der ADSI-Webseite.
Weitere Informationen
CommandType-Eigenschaft (ADO)
ConnectionString-Eigenschaft (ADO)
Properties-Collection (ADO)
Provider-Eigenschaft (ADO)
Recordset-Objekt (ADO)
Supports-Methode