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=MyPassword;"  

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