Fournisseur Microsoft OLE DB pour le service Microsoft Active Directory
Le fournisseur ADSI (Active Directory Service Interfaces) permet à ADO de se connecter à des services d’annuaire hétérogènes via ADSI. Cela permet aux applications ADO d’accéder en lecture seule aux services d’annuaire Microsoft Windows NT 4.0 et Microsoft Windows 2000, en plus des services d’annuaire compatibles LDAP et des services d’annuaires Novell. ADSI lui-même est basé sur un modèle de fournisseur, de sorte que s’il existe un nouveau fournisseur donnant accès à un autre annuaire, l’application ADO pourra y accéder en toute transparence. Le fournisseur ADSI est à threads libres et compatible Unicode.
Paramètres de chaîne de connexion
Pour vous connecter à ce fournisseur, définissez l'argument Provider de la propriété ConnectionString sur ce qui suit :
ADSDSOObject
La lecture de la propriété Provider retourne également cette chaîne.
Chaîne de connexion classique
Une chaîne de connexion classique pour ce fournisseur est la suivante :
"Provider=ADSDSOObject;User ID=MyUserID;Password=<password>;"
La chaîne consiste en les mots clés suivants.
| Mot-clé | Description |
|---|---|
| fournisseur | Spécifie le fournisseur OLE DB pour le service Active Directory. |
| identifiant utilisateur | Spécifie le nom d’utilisateur. Si ce mot clé est omis, l’ouverture de session actuelle est utilisée. |
| mot de passe | Spécifie le mot de passe de l’utilisateur. Si ce mot clé est omis. Ensuite, l’ouverture de session actuelle est utilisée. |
Note
Si vous vous connectez à un fournisseur de sources de données qui prend en charge l’authentification Windows, vous devez spécifier Trusted_Connection=oui ou sécurité intégrée = SSPI au lieu des informations d’ID d’utilisateur et de mot de passe dans la chaîne de connexion.
Texte de la commande
Une chaîne de texte de commande en quatre parties est reconnue par le fournisseur dans la syntaxe suivante :
"Root; Filter; Attributes[; Scope]"
| Valeur | Description |
|---|---|
| Racine | Indique l’objet ADsPath à partir duquel démarrer 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. |
| Portée | Optionnel. Chaîne qui spécifie 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 - Rechercher un seul niveau. - Sous-arborescence : recherchez l’ensemble de la sous-arborescence. |
Par exemple:
"<LDAP://DC=ArcadiaBay,DC=COM>;(objectClass=*);sn, givenName; subtree"
Le fournisseur prend également 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'"
Remarques
Le fournisseur n’accepte pas les appels de procédure stockée ou les noms de tables simples (par exemple, la propriété CommandType sera toujours adCmdText). Consultez la documentation relative aux interfaces de service Active Directory pour obtenir une description plus approfondie des éléments de texte de commande.
Comportement de l'ensemble d'enregistrements
Les tableaux suivants répertorient les caractéristiques disponibles sur un objet de jeu d'enregistrements utilisé avec ce fournisseur. Seul le type de curseur statique (adOpenStatic) est disponible.
Pour plus d’informations sur le comportement du Recordset pour la configuration de votre fournisseur, exécutez la méthode Supports et énumérez la collection Properties du Recordset pour déterminer si les propriétés dynamiques spécifiques au fournisseur sont présentes.
Disponibilité des propriétés standard ADO Recordset :
| Propriété | Disponibilité |
|---|---|
| AbsolutePage | lecture/écriture |
| AbsolutePosition | lecture/écriture |
| ActiveConnection | lecture seule |
| BOF | lecture seule |
| marque-page | lecture/écriture |
| CacheSize | lecture/écriture |
| EmplacementDuCurseur | toujours adUseServer |
| CursorType | toujours adOpenStatic |
| Mode d'édition | toujours adEditNone |
| EOF | lecture seule |
| filtre | lecture/écriture |
| LockType | lecture/écriture |
| MarshalOptions | non disponible |
| MaxRecords | lecture/écriture |
| NombreDePages | lecture seule |
| Taille de la Page | lecture/écriture |
| NombreEnregistrements | lecture seule |
| Source | lecture/écriture |
| État | lecture seule |
| Statut | lecture seule |
Disponibilité des méthodes d'objet Recordset ADO standard :
| Méthode | Disponible? |
|---|---|
| AjouterNouveau | Non |
| Annuler | Non |
| CancelBatch | Non |
| Annuler la mise à jour | Non |
| Cloner | Oui |
| Fermer | Oui |
| Supprimer | Non |
| GetRows | Oui |
| Déplacer | Oui |
| AllerAuDébut | Oui |
| DéplacerDernier | Oui |
| MoveNext | Oui |
| DéplacerPrécédent | Oui |
| EnregistrementSuivant | Oui |
| Ouvrir | Oui |
| Nouvelle requête | Oui |
| Resynchroniser | Oui |
| prend en charge | Oui |
| Mise à jour | Non |
| UpdateBatch | Non |
Pour plus d’informations sur ADSI et les spécificités du fournisseur, reportez-vous à la documentation des interfaces de service Active Directory ou visitez la page web ADSI.
Voir aussi
CommandType, propriété (ADO)
ConnectionString, propriété (ADO)
Collection de Propriétés (ADO)
Propriété du fournisseur (ADO)
objet Recordset (ADO)
prend en charge la méthode