Condividi tramite


Microsoft OLE DB Provider per il Servizio Microsoft Active Directory

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 di Microsoft Windows NT 4.0 e Microsoft Windows 2000, oltre a qualsiasi servizio directory conforme a LDAP e ai servizi directory di Novell. ADSI stesso si basa su un modello di provider, in modo che se esiste un nuovo provider che concede l'accesso a un'altra directory, l'applicazione ADO sarà in grado di accedervi senza problemi. Il provider ADSI è a thread libero e unicode abilitato.

Parametri della stringa di connessione

Per connettersi a questo provider, impostare l'argomento Provider della proprietà ConnectionString su quanto segue:

ADSDSOObject  

Anche la lettura della proprietà del provider restituirà 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 Specifica il provider OLE DB per il servizio Active Directory.
ID utente Specifica il nome utente. Se questa parola chiave viene omessa, viene usato l'accesso corrente.
password Specifica la password utente. Se questa parola chiave viene omessa. L'accesso corrente viene quindi utilizzato.

Nota

Se ci si connette a un provider di origini 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
radice Indica l'oggetto ADsPath da cui avviare la ricerca, ovvero la radice della ricerca.
filtro Indica il filtro di ricerca nel formato RFC 1960.
attributi Indica un elenco delimitato da virgole di attributi da restituire.
ambito Opzionale. String che specifica l'ambito della ricerca. Può essere uno dei seguenti:

- Base: consente di cercare solo l'oggetto di base (radice della ricerca).
- OneLevel - Cerca un solo livello.
- Sottoalbero: cercare l'intero sottoalbero.

Per esempio:

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

Il provider supporta anche SQL SELECT per il testo del comando. Per 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 alle interfacce del servizio Active Directory.

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 del recordset per la configurazione del provider, eseguire il metodo Supports ed enumerare la raccolta Proprietà del Recordset per determinare se sono presenti proprietà dinamiche specifiche per il provider.

Disponibilità delle proprietà recordset ADO standard:

Proprietà Disponibilità
PaginaAssoluta lettura/scrittura
posizioneAssoluta lettura/scrittura
ConnessioneAttiva sola lettura
BOF sola lettura
segnalibro lettura/scrittura
CacheSize lettura/scrittura
CursorLocation sempre adUseServer
TipoCursore sempre adOpenStatic
Modalità Modifica sempre adEditNone
EOF sola lettura
filtro lettura/scrittura
LockType lettura/scrittura
MarshalOptions non disponibile
MaxRecords lettura/scrittura
ConteggioPagine sola lettura
DimensionePagina lettura/scrittura
ConteggioRecord sola lettura
origine lettura/scrittura
stato sola lettura
stato sola lettura

Disponibilità dei metodi recordset ADO standard:

Metodo Disponibile?
AggiungiNuovo NO
Annulla NO
AnnullaBatch NO
AnnullaAggiornamento NO
Clone
Chiudi
Eliminare NO
GetRows
Sposta
MoveFirst
SpostaUltimo
MoveNext
Precedente
ProssimoRecordset
Apri
requery
Risincronizzare
supporta
aggiornamento NO
AggiornaBatch NO

Per altre informazioni su ADSI e sulle specifiche del provider, vedere la documentazione relativa alle interfacce del servizio Active Directory o visitare la pagina Web ADSI.

Vedere anche

proprietà CommandType (ADO)
proprietà ConnectionString (ADO)
Collezione Properties (ADO)
Proprietà Provider (ADO)
oggetto Recordset (ADO)
supporta la del metodo