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=MyPassword;"  

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