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=MyPassword;"  

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