Fournisseur Microsoft OLE DB pour Microsoft Active Directory Service

S’applique à : Access 2013, Office 2013

Le fournisseur ADSI (Microsoft Active Directory Service Interfaces) permet à ADO de se connecter à des services d'annuaire hétérogènes via ADSI. Les applications ADO bénéficient ainsi d'un accès en lecture seule aux services d'annuaire de Microsoft Windows NT 4.0 et de Microsoft Windows 2000, ainsi qu'aux services d'annuaire Novell ou compatibles avec LDAP. ADSI est basé sur un modèle de fournisseur ; par conséquent, si un nouveau fournisseur donne accès à un autre annuaire, l'application ADO pourra y accéder de façon transparente. Le fournisseur ADSI est libre de thread et utilise Unicode.

Paramètres de la chaîne de connexion

Pour vous connecter à ce fournisseur, définissez l’argument Provider de la propriété ConnectionString sur :

 
ADSDSOObject 

La lecture de la propriété Provider renverra également cette chaîne.

Chaîne de connexion classique

Voici une chaîne de connexion classique pour ce fournisseur :

 
"Provider=ADSDSOObject;User ID=userName;Password=userPassword;" 

La chaîne est composée des mots clé suivants :

Mot clé	Description
Provider	Spécifie le fournisseur OLE DB pour le service Microsoft Active Directory.
User ID	Spécifie le nom de l'utilisateur. Si ce mot clé n'est pas spécifié, les paramètres de connexion actuels sont utilisés.
Password	Spécifie le mot de passe de l'utilisateur. Si ce mot clé n'est pas spécifié, les paramètres de connexion actuels sont utilisés.

Texte de la commande

Dans la syntaxe suivante, une chaîne de texte de commande en quatre parties est reconnue par le fournisseur :

"Root; Filter; Attributes[; Scope]"

Valeur	Description
Root	Indique l'objet ADsPath à partir duquel lancer la recherche (c'est-à-dire la racine de la recherche).
Filtre	Indique le filtre de recherche au format RFC 1960.
Attributs	Indique une liste délimitée par des virgules d'attributs à renvoyer.
Scope	Optional. Chaîne spécifiant l'étendue de la recherche. Il peut s’agir de l’un des éléments suivants : Base — Rechercher uniquement l’objet de base (racine de la recherche). OneLevel : recherchez un seul niveau. Sous-arborescence : recherche dans l’ensemble de la sous-arborescence.

Par exemple :

 
"<LDAP://DC=ArcadiaBay,DC=COM>;(objectClass=*);sn, givenName; subtree" 

Le fournisseur prend aussi en charge SQL SELECT pour le texte de commande. Par exemple :

 
"SELECT title, telephoneNumber From 'LDAP://DC=Microsoft, DC=COM' WHERE 
objectClass='user' AND objectCategory='Person'" 

Le fournisseur n’accepte pas les appels de procédures stockées ni les noms de table simples (par exemple, la propriété CommandType sera toujours adCmdText). Pour obtenir une description plus complète des éléments du texte de commande, consultez la documentation ADSI.

Comportement des jeux d'enregistrements

Les tableaux suivants répertorient les fonctionnalités disponibles pour un objet Recordset ouvert avec ce fournisseur. Seul le type de curseur statique (adOpenStatic) est disponible.

Pour obtenir des informations détaillées sur le comportement de l'objet Recordset en fonction de la configuration de votre fournisseur, exécutez la méthode Supports et passez en revue la collection Properties du Recordset pour voir s'il existe des propriétés dynamiques spécifiques à ce fournisseur.

Disponibilité des propriétés ADO standard d'un Recordset :

Propriété	Disponibilité
AbsolutePage	lecture/écriture
AbsolutePosition	lecture/écriture
ActiveConnection	en lecture seule
BOF	en lecture seule
Bookmark	lecture/écriture
CacheSize	lecture/écriture
CursorLocation	Toujours adUseServer
CursorType	Toujours adOpenStatic
EditMode	Toujours adEditNone
EOF	en lecture seule
Filtre	lecture/écriture
LockType	lecture/écriture
MarshalOptions	non disponible
MaxRecords	lecture/écriture
PageCount	en lecture seule
PageSize	lecture/écriture
RecordCount	en lecture seule
Source	lecture/écriture
État	en lecture seule
État	en lecture seule

Disponibilité des méthodes ADO standard d'un Recordset :

Méthode	Disponible?
AddNew	Non
Cancel	Non
CancelBatch	Non
CancelUpdate	Non
Clone	Oui
Close	Oui
Supprimer	Non
GetRows	Oui
Déplacer	Oui
MoveFirst	Oui
MoveLast	Oui
MoveNext	Oui
MovePrevious	Oui
NextRecordset	Oui
Ouvert	Oui
Requery	Oui
Resync	Oui
Soutient	Oui
Mettre à jour	Non
UpdateBatch	Non