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