Proveedor Microsoft OLE DB para Servicios de directorio de Microsoft

El proveedor de interfaces de servicio de Active Directory (ADSI) permite a ADO conectarse a servicios de directorio heterogéneos a través de ADSI. Esto proporciona a las aplicaciones de ADO acceso de solo lectura a los servicios de directorio de Microsoft Windows NT 4.0 y Microsoft Windows 2000, además de cualquier servicio de directorio compatible con LDAP y servicios de directorio Novell. ADSI se basa en un modelo de proveedor, por lo que si hay un nuevo proveedor que da acceso a otro directorio, la aplicación ADO puede acceder a él sin problemas. El proveedor ADSI está habilitado para subprocesos gratuitos y Unicode.

Parámetros de la cadena de conexión

Para conectarse a este proveedor, establezca el argumento Provider de la propiedad ConnectionString en:

ADSDSOObject  

La lectura de la propiedad Provider también devuelve esta cadena.

Cadena de conexión típica

Una cadena de conexión típica para este proveedor es la siguiente:

"Provider=ADSDSOObject;User ID=MyUserID;Password=MyPassword;"  

La cadena consta de las siguientes palabras clave.

Palabra clave	Descripción
Proveedor	Especifica el proveedor Microsoft OLE DB para el servicio Active Directory.
Id. de usuario	Especifica el nombre de usuario. Si se omite esta palabra clave, se usa el inicio de sesión actual.
Contraseña	Especifica la contraseña de usuario. Si se omite esta palabra clave. A continuación, se usa el inicio de sesión actual.

Nota

Si se conecta a un proveedor de orígenes de datos que admite autenticación de Windows, debe especificar Trusted_Connection=sí o Seguridad integrada = SSPI en lugar de la información de identificador de usuario y contraseña en la cadena de conexión.

Texto de comando

El proveedor reconoce una cadena de texto de comando de cuatro partes en la siguiente sintaxis:

"Root; Filter; Attributes[; Scope]"  

Value	Descripción
Root	Indica el objeto ADsPath desde el que se va a iniciar la búsqueda (es decir, la raíz de la búsqueda).
Filter	Indica el filtro de búsqueda en el formato RFC 1960.
Atributos	Indica una lista delimitada por comas de atributos que se van a devolver.
Ámbito	Opcional. Cadena que especifica el ámbito de la búsqueda. Puede ser uno de los siguientes: - Base - Buscar solo el objeto base (raíz de la búsqueda). - OneLevel - Buscar solo un nivel. - Subárbol - Buscar en todo el subárbol.

Por ejemplo:

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

El proveedor también admite SQL SELECT para el texto del comando. Por ejemplo:

"SELECT title, telephoneNumber From 'LDAP://DC=Microsoft, DC=COM' WHERE   
objectClass='user' AND objectCategory='Person'"  

Observaciones

El proveedor no acepta llamadas a procedimientos almacenados ni nombres de tabla simples (por ejemplo, la propiedad CommandType siempre es adCmdText). Consulte la documentación de las interfaces de servicio de Active Directory para obtener una descripción más detallada de los elementos de texto del comando.

Comportamiento del conjunto de registros

En las siguientes tablas se enumeran las características disponibles en un objeto Recordset abierto mediante este proveedor. Solo está disponible el tipo de cursor estático (adOpenStatic).

Para obtener más información sobre el comportamiento del objeto Recordseten la configuración del proveedor, ejecute el método Supports y enumere la colección Properties del Recordset para determinar si existen propiedades dinámicas específicas del proveedor.

Disponibilidad de las propiedades estándar del conjunto de registros de ADO:

Propiedad	Disponibilidad
AbsolutePage	lectura/escritura
AbsolutePosition	lectura/escritura
ActiveConnection	solo lectura
BOF	solo lectura
Marcador	lectura/escritura
CacheSize	lectura/escritura
CursorLocation	always adUseServer
CursorType	always adOpenStatic
EditMode	always adEditNone
EOF	solo lectura
Filter	lectura/escritura
LockType	lectura/escritura
MarshalOptions	no disponible
MaxRecords	lectura/escritura
PageCount	solo lectura
PageSize	lectura/escritura
RecordCount	solo lectura
Origen	lectura/escritura
State	solo lectura
Estado	solo lectura

Disponibilidad de los métodos estándar del conjunto de registros de ADO:

Método	¿Disponible?
AddNew	No
Cancelar	No
CancelBatch	No
CancelUpdate	No
Clonar	Sí
Cerrar	Sí
Eliminar	No
GetRows	Sí
Mover	Sí
MoveFirst	Sí
MoveLast	Sí
MoveNext	Sí
MovePrevious	Sí
NextRecordset	Sí
Abrir	Sí
Requery	Sí
Resync	Sí
Es compatible con	Sí
Actualizar	No
UpdateBatch	No

Para obtener más información sobre ADSI y los detalles del proveedor, consulte la documentación de las interfaces de servicio de Active Directory o visite la página web ADSI.

Consulte también

Propiedad CommandType (ADO)
Propiedad ConnectionString (ADO)
Colección de propiedades (ADO)
Propiedad de proveedor (ADO)
Objeto de conjunto de registros (ADO)
Método Supports