Fournisseur Microsoft OLE DB pour Microsoft Active Directory Service
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 compatible LDAP et des services d’annuaire 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 répertoire, l’application ADO pourra y accéder en toute transparence. Le fournisseur ADSI est libre et compatible avec Unicode.
Paramètres de chaîne de connexion
Pour vous connecter à ce fournisseur, définissez l’argument Fournisseur de la propriété ConnectionString sur la propriété suivante :
ADSDSOObject
La lecture de la propriété Fournisseur retourne également cette chaîne.
Chaîne de connexion typique
Une chaîne de connexion typique pour ce fournisseur est la suivante :
"Provider=ADSDSOObject;User ID=MyUserID;Password=MyPassword;"
La chaîne se compose des mots clés suivants.
| Mot clé | Description |
|---|---|
| Fournisseur | Spécifie le fournisseur OLE DB pour le service Active Directory. |
| ID d'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 utilisateur. Si ce mot clé est omis. Ensuite, l’ouverture de session actuelle est utilisée. |
Notes
Si vous vous connectez à un fournisseur de sources de données qui prend en charge l’authentification Windows, vous devez spécifier Trusted_Connection=yes ou Integrated Security = SSPI au lieu des informations d’ID 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 |
|---|---|
| Root | Indique l’objet ADsPath à partir duquel démarrer la recherche (c’est-à-dire la racine de la recherche). |
| Filter | Indique le filtre de recherche au format RFC 1960. |
| Attributs | Indique une liste délimitée par des virgules d’attributs à renvoyer. |
| Portée | facultatif. Chaîne qui spécifie l’étendue de la recherche. Il peut s'agir d'une des méthodes suivantes : - 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'"
Notes
Le fournisseur n’accepte pas les appels de procédure stockée ou les noms de table simples (par exemple, la propriété CommandType sera toujours adCmdText). Consultez la documentation sur les interfaces de service Active Directory pour obtenir une description plus approfondie des éléments de texte de commande.
Comportement de Recordset
Les tableaux suivants énumèrent les fonctionnalités disponibles sur un objet Recordset ouvert en utilisant ce fournisseur. Seul le type de curseur statique (adOpenStatic) est disponible.
Pour plus d’informations sur le comportement de Recordset pour la configuration de votre fournisseur, exécutez la méthode Supports et énumérez la collection Propriétés de l’objet Recordset pour déterminer si les propriétés dynamiques spécifiques au fournisseur sont présentes.
Disponibilité des propriétés standard de ADO Recordset :
| Propriété | Disponibilité |
|---|---|
| AbsolutePage | lecture/écriture |
| AbsolutePosition | lecture/écriture |
| ActiveConnection | en lecture seule |
| BOF | en lecture seule |
| Signet | lecture/écriture |
| CacheSize | lecture/écriture |
| CursorLocation | toujours adUseServer |
| CursorType | toujours adOpenStatic |
| EditMode | toujours adEditNone |
| EOF | en lecture seule |
| Filter | 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 |
| State | en lecture seule |
| État | en lecture seule |
Disponibilité des méthodes standard ADO Recordset :
| Méthode | Disponible ? |
|---|---|
| AddNew | Non |
| Annuler | Non |
| CancelBatch | Non |
| CancelUpdate | Non |
| Cloner | Oui |
| Close | Oui |
| Supprimer | No |
| GetRows | Oui |
| Déplacer | Oui |
| MoveFirst | Oui |
| MoveLast | Oui |
| MoveNext | Oui |
| MovePrevious | Oui |
| NextRecordset | Oui |
| Ouvrir | Oui |
| Requery | Oui |
| Resync | Oui |
| Prise en charge | Oui |
| Mettre à jour | No |
| UpdateBatch | Non |
Pour plus d'informations sur ADSI et les spécificités du fournisseur, consultez la documentation sur les interfaces de service Active Directory ou visitez la page Web ADSI.
Voir aussi
CommandType, propriété (ADO)
ConnectionString, propriété (ADO)
Properties, collection (ADO)
Provider, propriété (ADO)
Recordset, objet (ADO)
Supports, méthode