Provider Microsoft OLE DB per Microsoft Active Directory Service
Il provider Active Directory Service Interfaces (ADSI) consente ad ADO di connettersi a servizi directory eterogenei tramite ADSI. In questo modo, le applicazioni ADO possono accedere in sola lettura ai servizi directory Microsoft Windows NT 4.0 e Microsoft Windows 2000, oltre a qualsiasi servizio directory conforme a LDAP e ai servizi directory Novell. ADSI si basa su un modello di provider, quindi, se un nuovo provider concede l'accesso a un'altra directory, l'applicazione ADO sarà in grado di accedervi senza problemi. Il provider ADSI è free threaded e abilitato per Unicode.
Parametri della stringa di connessione
Per connettersi a questo provider, impostare l'argomento Provider della proprietà ConnectionString come segue:
ADSDSOObject
La lettura della proprietà Provider restituirà anche questa stringa.
Stringa di connessione tipica
Una stringa di connessione tipica per questo provider è la seguente:
"Provider=ADSDSOObject;User ID=MyUserID;Password=<password>;"
La stringa è costituita dalle parole chiave seguenti.
| Parola chiave | Descrizione |
|---|---|
| Provider | Consente di specificare il provider OLE DB per il servizio Active Directory. |
| ID utente | Specifica il nome dell'utente. Se questa parola chiave viene omessa, viene usato l'accesso corrente. |
| Password | Consente di specificare la password dell'utente. Se questa parola chiave viene omessa, viene usato l'accesso corrente. |
Nota
Se ci si connette a un provider di origine dati che supporta l'autenticazione di Windows, è necessario specificare Trusted_Connection=yes o Integrated Security = SSPI anziché le informazioni sull'ID utente e sulla password nella stringa di connessione.
Testo comando
Una stringa di testo del comando in quattro parti viene riconosciuta dal provider nella sintassi seguente:
"Root; Filter; Attributes[; Scope]"
| Valore | Descrizione |
|---|---|
| Root | Indica l'oggetto ADsPath da cui avviare la ricerca, ovvero la radice della ricerca. |
| Filtra | Indica il filtro di ricerca nel formato RFC 1960. |
| Attributi | Indica un elenco delimitato da virgole di attributi da restituire. |
| Scope | Facoltativo. Stringa che specifica l’ambito della ricerca. Può essere uno dei seguenti: - Base: cerca solo nell'oggetto di base (radice della ricerca). - OneLevel: cerca solo in un livello. - Subtree: cerca nell'intero sottoalbero. |
Ad esempio:
"<LDAP://DC=ArcadiaBay,DC=COM>;(objectClass=*);sn, givenName; subtree"
Il provider supporta anche SQL SELECT per il testo del comando. Ad esempio:
"SELECT title, telephoneNumber From 'LDAP://DC=Microsoft, DC=COM' WHERE
objectClass='user' AND objectCategory='Person'"
Osservazioni:
Il provider non accetta chiamate di stored procedure o nomi di tabella semplici (ad esempio la proprietà CommandType sarà sempre adCmdText). Per una descrizione più approfondita degli elementi di testo del comando, vedere la documentazione relativa a Active Directory Service Interfaces.
Comportamento dell'oggetto Recordset
Nelle tabelle seguenti sono elencate le funzionalità disponibili in un oggetto Recordset aperto tramite questo provider. È disponibile solo il tipo di cursore statico (adOpenStatic).
Per altre informazioni sul comportamento di Recordset per la configurazione del provider, eseguire il metodo Supports ed enumerare la raccolta Properties di Recordset per determinare se sono presenti proprietà dinamiche specifiche del provider.
Disponibilità delle proprietà ADO Recordset standard:
| Proprietà | Disponibilità |
|---|---|
| AbsolutePage | lettura/scrittura |
| AbsolutePosition | lettura/scrittura |
| ActiveConnection | sola lettura |
| BOF | sola lettura |
| Bookmark | lettura/scrittura |
| CacheSize | lettura/scrittura |
| CursorLocation | sempre adUseServer |
| CursorType | sempre adOpenStatic |
| EditMode | sempre adEditNone |
| EOF | sola lettura |
| Filtra | lettura/scrittura |
| LockType | lettura/scrittura |
| MarshalOptions | non disponibile |
| MaxRecords | lettura/scrittura |
| PageCount | sola lettura |
| PageSize | lettura/scrittura |
| RecordCount | sola lettura |
| Origine | lettura/scrittura |
| Stato | sola lettura |
| Stato | sola lettura |
Disponibilità dei metodi ADO Recordset standard:
| metodo | Disponibile? |
|---|---|
| AddNew | No |
| Annulla | No |
| CancelBatch | No |
| CancelUpdate | No |
| Clona | Sì |
| Chiudi | Sì |
| CANC | No |
| GetRows | Sì |
| Sposta | Sì |
| MoveFirst | Sì |
| MoveLast | Sì |
| MoveNext | Sì |
| MovePrevious | Sì |
| NextRecordset | Sì |
| Si apra | Sì |
| Requery | Sì |
| Resync | Sì |
| Supporti | Sì |
| Aggiornamento | No |
| UpdateBatch | No |
Per altre informazioni su ADSI e sulle specifiche del provider, vedere la documentazione di Active Directory Service Interfaces o visitare la pagina Web di ADSI.
Vedi anche
Proprietà CommandType (ADO)
Proprietà ConnectionString (ADO)
Raccolta delle proprietà (ADO)
Proprietà Provider (ADO)
Oggetto Recordset (ADO)
Metodo Supports