Proveedor OLE DB de Microsoft para el servicio Microsoft Active Directory
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 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 proporciona acceso a otro directorio, la aplicación ADO podrá acceder a ella sin problemas. El proveedor ADSI es multihilo y está habilitado para Unicode.
Parámetros de cadena de conexión
Para conectarse a este proveedor, establezca el argumento Provider de la propiedad ConnectionString a lo siguiente:
ADSDSOObject
Al leer la propiedad Proveedor , también se devolverá 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=<password>;"
La cadena consta de las siguientes palabras clave.
| Palabra clave | Descripción |
|---|---|
| Proveedor | Especifica el proveedor OLE DB para el servicio Active Directory. |
| Identificador 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 origen de datos que admite la autenticación de Windows, debe especificar Trusted_Connection=sí o Integrated Security = SSPI en lugar del identificador de usuario y la información de contraseña en la cadena de conexión.
Texto del comando
El proveedor reconoce una cadena de texto de comandos de cuatro partes en la sintaxis siguiente:
"Root; Filter; Attributes[; Scope]"
| Valor | Descripción |
|---|---|
| Raíz | Indica el ADsPath objeto desde el que iniciar la búsqueda (es decir, la raíz de la búsqueda). |
| Filtro | Indica el filtro de búsqueda en formato RFC 1960. |
| atributos de | Indica una lista delimitada por comas de atributos que se van a devolver. |
| ámbito | Opcional.
string que especifica el ámbito de la búsqueda. Puede ser uno de los siguientes: - Base: busque solo el objeto base (raíz de la búsqueda). - OneLevel- Buscar solo un nivel. - Subárbol : busque 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 será 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 tablas siguientes se enumeran las características disponibles en un objeto Recordset de abierto mediante este proveedor. Solo está disponible el tipo de cursor estático (adOpenStatic).
Para obtener más información sobre el comportamiento de Recordset en la configuración de su proveedor, ejecute el método Supports y enumere la colección Properties del Recordset para determinar si hay propiedades dinámicas específicas del proveedor.
Disponibilidad de las propiedades estándar del conjunto de registros de ADO:
| Propiedad | Disponibilidad |
|---|---|
| PáginaAbsoluta | lectura y escritura |
| PosiciónAbsoluta | lectura y escritura |
| ActiveConnection | solo lectura |
| BOF | solo lectura |
| marcador | lectura y escritura |
| Tamaño de Caché | lectura y escritura |
| UbicaciónDelCursor | siempre adUseServer |
| CursorType | siempre adOpenStatic |
| ModoEdición | siempre adEditNone |
| EOF | solo lectura |
| filtro | lectura y escritura |
| lockType | lectura y escritura |
| OpcionesDeMarshall | no disponible |
| MaxRecords | lectura y escritura |
| PageCount | solo lectura |
| Tamaño de Página | lectura y escritura |
| ConteoDeRegistros | solo lectura |
| de origen | lectura y escritura |
| de estado | solo lectura |
| estado | solo lectura |
Disponibilidad de los métodos de Recordset estándar de ADO:
| Método | ¿Disponible? |
|---|---|
| AgregarNuevo | No |
| Cancelar | No |
| CancelBatch | No |
| CancelarActualización | No |
| Clonar | Sí |
| Cerrar | Sí |
| Eliminar | No |
| GetRows | Sí |
| Mover | Sí |
| MoverPrimero | Sí |
| MoveLast | Sí |
| MoveNext | Sí |
| MovePrevious | Sí |
| NextRecordset | Sí |
| Abrir | Sí |
| reconsulta | Sí |
| resincronizar | Sí |
| soporta | Sí |
| Actualizar | No |
| actualizarLote | No |
Para obtener más información sobre ADSI y los detalles del proveedor, consulte la documentación sobre las Interfaces de Servicio de Active Directory o visite la página web de ADSI.
Consulte también
propiedad CommandType (ADO)
propiedad ConnectionString (ADO)
Colección de Propiedades (ADO)
Propiedad del Proveedor (ADO)
objeto Recordset (ADO)
soporta Método