Provedor OLE DB da Microsoft para o Serviço Active Directory da Microsoft
O provedor ADSI (Interfaces de Serviço) do Active Directory permite que o ADO se conecte a serviços de diretório heterogêneos por meio de ADSI. Isso fornece aos aplicativos ADO acesso somente leitura aos serviços de diretório Microsoft Windows NT 4.0 e Microsoft Windows 2000, além de qualquer serviço de diretório compatível com LDAP e Novell Directory Services. O adsi em si é baseado em um modelo de provedor, de modo que, se houver um novo provedor dando acesso a outro diretório, o aplicativo ADO poderá acessá-lo perfeitamente. O provedor ADSI é livre e habilitado para Unicode.
Parâmetros de cadeia de conexão
Para se conectar a esse provedor, defina o argumento Provider da propriedade ConnectionString para o seguinte:
ADSDSOObject
Ler a propriedade Provedor de também retornará essa string.
Cadeia de conexão típica
Uma cadeia de conexão típica para esse provedor é a seguinte:
"Provider=ADSDSOObject;User ID=MyUserID;Password=<password>;"
A cadeia de caracteres consiste nas palavras-chave a seguir.
| Palavra-chave | Descrição |
|---|---|
| do provedor de | Especifica o Provedor OLE DB para o Serviço do Active Directory. |
| ID do usuário | Especifica o 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 é usado. |
Nota
Se você estiver se conectando a um provedor de fonte de dados que dê suporte à autenticação do Windows, especifique Trusted_Connection=sim ou Segurança Integrada = SSPI em vez de informações de ID de usuário e senha na cadeia de conexão.
Texto do comando
Uma cadeia de texto de comando de quatro partes é reconhecida pelo provedor na seguinte sintaxe:
"Root; Filter; Attributes[; Scope]"
| Valor | Descrição |
|---|---|
| raiz do | Indica o objeto ADsPath do qual iniciar a pesquisa (ou seja, a raiz da pesquisa). |
| Filtrar | Indica o filtro de pesquisa no formato RFC 1960. |
| atributos | Indica uma lista delimitada por vírgulas de atributos a serem retornados. |
| Escopo | Opcional. Um String que especifica o escopo da pesquisa. Pode ser um dos seguintes: - Base - Pesquise apenas o objeto base (raiz da pesquisa). - OneLevel - Pesquisar apenas um nível. - Subárvore - Pesquisar 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'"
Observações
O provedor não aceita chamadas de procedimento armazenado ou nomes de tabela simples (por exemplo, a propriedade CommandType sempre será adCmdText). Consulte a documentação de Interfaces de Serviço do Active Directory para obter uma descrição mais completa dos elementos de texto de comando.
Comportamento do conjunto de registros
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 seu 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 do ADO Recordset:
| Propriedade | Disponibilidade |
|---|---|
| AbsolutePage | leitura/gravação |
| absolutePosition | leitura/gravação |
| ConexãoAtiva | somente leitura |
| BOF | somente leitura |
| Marcador | leitura/gravação |
| CacheSize | leitura/gravação |
| cursorLocation | sempre adUseServer |
| TipoDeCursor | sempre adOpenStatic |
| Modo de Edição | sempre adEditNone |
| EOF | somente leitura |
| Filtrar | leitura/gravação |
| TipoDeTranca | leitura/gravação |
| MarshalOptions | não disponível |
| MaxRecords | leitura/gravação |
| ContagemDePáginas | somente leitura |
| Tamanho da Página | leitura/gravação |
| ContagemDeRegistros | somente leitura |
| origem | leitura/gravação |
| State | somente leitura |
| de Status do | somente leitura |
Disponibilidade dos métodos padrão do ADO Recordset:
| Método | Disponível? |
|---|---|
| AdicionarNovo | Não |
| cancelar | Não |
| CancelBatch | Não |
| CancelarAtualização | Não |
| Clonar | Sim |
| fechar | Sim |
| excluir | Não |
| GetRows | Sim |
| mover | Sim |
| MoveFirst | Sim |
| MoveLast | Sim |
| MoveNext | Sim |
| MovePrevious | Sim |
| NextRecordset | Sim |
| Abrir | Sim |
| Requery | Sim |
| Ressincronização | Sim |
| dá suporte a | Sim |
| Atualizar | Não |
| AtualizarLote | Não |
Para obter mais informações sobre ADSI e as especificidades do provedor, consulte a documentação de Interfaces de Serviço do Active Directory ou visite a página da Web ADSI.
Consulte Também
Propriedade CommandType (ADO)
Propriedade ConnectionString (ADO)
da coleção Properties (ADO)
Propriedade do Provedor (ADO)
do objeto Recordset (ADO)
dá suporte ao método