Provedor Microsoft OLE DB para Active Directory Domain Service
O provedor ADSI (Active Directory Service Interfaces) permite que a ADO se conecte a serviços de diretório heterogêneos por meio do ADSI. Isso fornece aos aplicativos da ADO o acesso somente leitura aos serviços de diretório Microsoft Windows NT 4.0 e Microsoft Windows 2000, além dos serviços de diretório compatíveis com LDAP e Serviços de Diretório Novell. O próprio ADSI é baseado em um modelo de provedor, de modo que, se houver um novo provedor dando acesso a outro diretório, o aplicativo da ADO poderá acessá-lo perfeitamente. O provedor do ADSI é free-threaded e está habilitado para Unicode.
Parâmetros de cadeia de conexão
Para se conectar a esse provedor, defina o argumento Provider da propriedade ConnectionString como o seguinte:
ADSDSOObject
A leitura da propriedade Provider também retornará essa cadeia de caracteres.
Cadeia de conexão típica
Uma cadeia de conexão típica para esse provedor é da seguinte maneira:
"Provider=ADSDSOObject;User ID=MyUserID;Password=<password>;"
A cadeia de caracteres consiste nas palavras-chave a seguir.
| Palavra-chave | Descrição |
|---|---|
| Provedor | Especifica o Provedor OLE DB para o Active Directory Service. |
| ID de usuário | Especifica um nome de usuário. Se essa palavra-chave for omitida, o logon atual será usado. |
| Senha | Especifica a senha do usuário. Se essa palavra-chave for omitida. Em seguida, o logon atual será usado. |
Observação
Se você estiver se conectando a um provedor de fonte de dados que permite a autenticação do Windows, especifique Trusted_Connection=yes ou Segurança Integrada = SSPI, em vez das informações de ID do usuário e senha na cadeia de conexão.
Texto do comando
Uma cadeia de caracteres de texto de comando de quatro partes é reconhecida pelo provedor na seguinte sintaxe:
"Root; Filter; Attributes[; Scope]"
| Valor | Descrição |
|---|---|
| Root | Indica o objeto ADsPath a partir do qual a pesquisa é iniciada (ou seja, a raiz da pesquisa). |
| Filter | Indica o filtro de pesquisa no formato RFC 1960. |
| Atributos | Indica uma lista delimitada por vírgulas de atributos a serem retornados. |
| Escopo | Opcional. Uma cadeia de caracteres que especifica o escopo da pesquisa. Um dos seguintes pode ser feito: - Base – Pesquisa apenas o objeto base (raiz da pesquisa). - OneLevel – Pesquisa apenas um nível. - Subárvore – Pesquisa toda a subárvore. |
Por exemplo:
"<LDAP://DC=ArcadiaBay,DC=COM>;(objectClass=*);sn, givenName; subtree"
O provedor também dá suporte ao SQL SELECT para texto de comando. Por exemplo:
"SELECT title, telephoneNumber From 'LDAP://DC=Microsoft, DC=COM' WHERE
objectClass='user' AND objectCategory='Person'"
Comentários
O provedor não aceita chamadas de procedimento armazenado ou nomes de tabelas simples (por exemplo, a propriedade CommandType sempre será adCmdText). Confira a documentação do Active Directory Service Interfaces, para obter uma descrição mais completa dos elementos de texto de comando.
Comportamento do Recordset
As tabelas a seguir listam os recursos disponíveis em um objeto Recordset aberto usando esse provedor. Somente o tipo de cursor estático (adOpenStatic) está disponível.
Para obter mais informações sobre o comportamento do Recordset para a configuração do provedor, execute o método Supports e enumere a coleção Properties do Recordset para determinar se as propriedades dinâmicas específicas do provedor estão presentes.
Disponibilidade das propriedades padrão de Recordset da ADO:
| Propriedade | Disponibilidade |
|---|---|
| AbsolutePage | leitura/gravação |
| AbsolutePosition | leitura/gravação |
| ActiveConnection | somente leitura |
| BOF | somente leitura |
| Indicador | leitura/gravação |
| CacheSize | leitura/gravação |
| CursorLocation | sempre adUseServer |
| CursorType | sempre adOpenStatic |
| EditMode | sempre adEditNone |
| EOF | somente leitura |
| Filter | leitura/gravação |
| LockType | leitura/gravação |
| MarshalOptions | não disponível |
| MaxRecords | leitura/gravação |
| PageCount | somente leitura |
| PageSize | leitura/gravação |
| RecordCount | somente leitura |
| Origem | leitura/gravação |
| State | somente leitura |
| Status | somente leitura |
Disponibilidade dos métodos padrão do Recordset da ADO:
| Método | Disponível? |
|---|---|
| AddNew | Não |
| Cancelar | Não |
| CancelBatch | Não |
| CancelUpdate | No |
| Clonar | Yes |
| Fechar | Yes |
| Delete (excluir) | No |
| GetRows | Yes |
| Mover | Yes |
| MoveFirst | Yes |
| MoveLast | Yes |
| MoveNext | Yes |
| MovePrevious | Yes |
| NextRecordset | Yes |
| Abrir | Yes |
| Requery | Yes |
| Resync | Yes |
| Suporta | Yes |
| Atualização | No |
| UpdateBatch | Não |
Para obter mais informações sobre ADSI e as especificidades do provedor, veja a documentação do Active Directory Service Interfaces ou acesse a página da Web ADSI.
Consulte Também
Propriedade CommandType (ADO)
Propriedade ConnectionString (ADO)
Coleção Properties (ADO)
Propriedade Provider (ADO)
Objeto Recordset (ADO)
Método Supports