Provedor Microsoft OLE DB para Microsoft Active Directory Service

Aplica-se ao: Access 2013, Office 2013

O provedor ADSI (Interfaces de Serviços do Active Directory) da Microsoft permite que o ADO conecte-se a serviços de diretório heterogêneos por meio de ADSI. Isso fornece aos aplicativos do ADO acesso somente leitura aos serviços de diretório do Microsoft Windows NT 4.0 e Microsoft Windows 2000, além de qualquer serviço de diretório compatível com o LDAP e os Serviços de Diretório da Novell. O ADSI em si é baseado em um modelo de provedor, portanto, se houver um novo provedor fornecendo acesso a outro diretório, o aplicativo do ADO poderá acessá-lo sem qualquer problema. O provedor ADSI é de encadeamento livre e habilitado para unicode.

Parâmetros de sequência de conexão

Para conectar-se a esse provedor, defina o argumento Provider da propriedade ConnectionString como:

 
ADSDSOObject 

A leitura da propriedade Provider também retornará essa cadeia de caracteres.

Sequência de conexão típica

Esta é uma sequência de conexão típica para esse provedor:

 
"Provider=ADSDSOObject;User ID=userName;Password=userPassword;" 

A cadeia de caracteres consiste nas seguintes palavras-chave:

Palavra-chave	Descrição
Provider	Especifica o Microsoft OLE DB Provider for Microsoft Indexing Service.
ID de usuário	Especifica o nome de usuário. Se essa palavra-chave for omitida, o logon atual será utilizado.
Password	Especifica a senha do usuário. Se essa palavra-chave for omitida, o logon atual será utilizado.

Texto de comando

Uma sequência de texto de comando de quatro partes é reconhecida pelo provedor na seguinte sintaxe:

"Root; Filter; Attributes[; Scope]"

Valor	Descrição
Raiz	Indica o objeto ADsPath a partir do qual iniciar a pesquisa (isto é, a raiz para a pesquisa).
Filtro	Indica o filtro da pesquisa no formato RFC 1960.
Atributos	Indica uma lista de atributos a ser retornada, delimitada por vírgula.
Escopo	Opcional. Uma String que especifica o escopo da pesquisa. Pode ser um dos seguintes: Base — pesquise apenas o objeto base (raiz da pesquisa). OneLevel – pesquise apenas um nível. Subtree – Pesquise toda a sub-árvore.

Por exemplo:

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

O provedor também oferece suporte à SQL SELECT para o texto de comando. Por exemplo:

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

O provedor não aceita chamadas de procedimento armazenado ou nomes simples de tabelas (por exemplo, a propriedade CommandType sempre será adCmdText). Consulte a documentação das Interfaces de Serviços do Active Directory para obter uma descrição mais completa dos elementos do texto de comando.

Comportamento do Recordset

As tabelas a seguir relacionam os recursos disponíveis em um objeto Recordset aberto com este provedor. Somente o tipo de cursor estático (adOpenStatic) está disponível.

Para obter informações mais detalhadas sobre o comportamento do Recordset na sua configuração de provedor, execute o método Supports e enumere a coleção Properties de Recordset para identificar se propriedades dinâmicas específicas para provedor estão presentes.

Disponibilidade das propriedades padrão do Recordset do ADO:

Propriedade	Disponibilidade
AbsolutePage	leitura/gravação
AbsolutePosition	leitura/gravação
ActiveConnection	somente leitura
BOF	somente leitura
Bookmark	leitura/gravação
CacheSize	leitura/gravação
Cursorlocation	sempre adUseServer
Cursortype	sempre adOpenStatic
EditMode	sempre adEditNone
EOF	somente leitura
Filtro	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
Fonte	leitura/gravação
Estado	somente leitura
Status	somente leitura

Disponibilidade de métodos padrão do Recordset do ADO:

Método	Disponível?
AddNew	Não
Cancel	Não
CancelBatch	Não
CancelUpdate	Não
Clone	Sim
Close	Sim
Delete	Não
GetRows	Sim
Mover	Sim
Movefirst	Sim
MoveLast	Sim
Movenext	Sim
Moveprevious	Sim
NextRecordset	Sim
Abrir	Sim
Requery	Sim
Resync	Sim
Suporta	Sim
Atualizar	Não
UpdateBatch	Não