---------------------------------------------------------
Arquivo Leiame de Extenses do Microsoft ActiveX Data Objects para DDL e Segurana
---------------------------------------------------------

(c) 1998 Microsoft Corporation. Todos os direitos reservados.

Este documento fornece informaes de ltima hora ou outras informaes que complementam a documentao das Extenses do Microsoft ADO para DDL e Segurana (ADOX).


--------
CONTEDO
--------

1. DESCRIO DO PRODUTO   

2. RECURSOS
   
3. OBSERVAES TCNICAS

4. ERROS CONHECIDOS, LIMITAES E SOLUES ALTERNATIVAS

-----------------------
1. DESCRIO DO PRODUTO
-----------------------

Extenses do Microsoft ActiveX Data Objects para Data Definition Language e Segurana (ADOX)  uma extenso aos objetos e modelo de programao ADO. O ADOX inclui objetos para criao e modificao de esquemas e tambm de segurana. Como ele  uma abordagem baseada em objeto para manipulao de esquemas, voc pode escrever cdigo que funcionar em vrias fontes de dados independentemente de diferenas em suas sintaxes nativas.

-----------
2. RECURSOS
-----------

O ADOX  uma biblioteca complementar dos objetos principais de ADO. Ele expe objetos adicionais para criao, modificao e excluso de objetos de esquema, como tabelas e procedimentos. Ele tambm inclui objetos de segurana para manter usurios e grupos e para conceder e revogar permisses para objetos.

-----------------------
3. OBSERVAES TCNICAS
-----------------------

3.1 Propriedades necessrias/opcionais de tabelas, ndices e colunas

Nem todas as propriedades de objetos de tabela, ndice e coluna podem ser suportadas por seu provedor de dados. Ocorrer um erro se voc definir um valor para uma propriedade que no  suportada pelo provedor. Para tabelas, ndices ou colunas novas o erro ocorrer quando o objeto for acrescentado  coleo. Para objetos existentes, o erro ocorrer ao definir a propriedade.

Ao criar objetos de tabela, ndice ou coluna, a existncia de um valor padro apropriado para uma propriedade opcional no garante que a propriedade seja suportada pelo seu provedor. Para obter mais informaes sobre quais propriedades so suportadas pelo seu provedor, consulte a documentao do provedor.

3.2 Usando o ADOX com provedores Microsoft OLE DB

Determinados recursos do ADOX no so suportados, dependendo do seu provedor de dados OLE DB. O ADOX  completamente suportado com o provedor Microsoft OLE DB para o Microsoft Jet Database Engine. Para o provedor Microsoft SQL Server OLE DB, o provedor Microsoft OLE DB para ODBC ou o provedor Microsoft OLE DB para Oracle, consulte abaixo. O ADOX no  suportado por nenhum outro provedor Microsoft OLE DB.

Provedor Microsoft SQL Server OLE DB

Todos os objetos, colees, propriedades e mtodos ADOX so suportados, exceto os listados aqui:

Catlogo: Mtodo Create.
Tabelas: Propriedades para tabelas existentes so somente leitura (propriedades para novas tabelas podem ser leitura e gravao).
Modos de exibio: No suportados.
Procedimentos: Mtodo Append, mtodo Delete, propriedade Command.
Chaves: Mtodo Append, mtodo Delete.
Usurios: No suportados.
Grupos: No suportados.

Provedor Microsoft OLE DB para ODBC

Todos os objetos, colees, propriedades e mtodos ADOX so suportados, exceto os listados aqui:

Catlogo: Mtodo Create.
Tabelas: Mtodo Append, mtodo Delete. Propriedades para tabelas existentes so somente leitura (propriedades para novas tabelas podem ser leitura e gravao).
Modos de exibio: Mtodo Append, mtodo Delete, propriedade Command.
Procedimentos: Mtodo Append, mtodo Delete, propriedade Command.
ndices: Mtodo Append, mtodo Delete.
Chaves: Mtodo Append, mtodo Delete.
Usurios: No suportados.
Grupos: No suportados.

Provedor Microsoft OLE DB para Oracle

Todos os objetos, colees, propriedades e mtodos ADOX so suportados, exceto os listados aqui:

Catlogo: Mtodo Create.
Tabelas: Mtodo Append, mtodo Delete. Propriedades para tabelas existentes so somente leitura (propriedades para novas tabelas podem ser leitura e gravao).
Modos de exibio: Mtodo Append, mtodo Delete, propriedade Command.
Procedimentos: Mtodo Append, mtodo Delete, propriedade Command.
ndices: Mtodo Append, mtodo Delete.
Chaves: Mtodo Append, mtodo Delete.
Usurios: No suportados.
Grupos: No suportados.


-------------------------------------------------------
4. ERROS CONHECIDOS, LIMITAES E SOLUES ALTERNATIVAS
-------------------------------------------------------

Os erros conhecidos do ADOX esto listados a seguir.

4.1 As propriedades DateCreated/DateModified requerem atualizao

As propriedades DateCreated e DateModified so NULL para objetos recm acrescentados. Depois de acrescentar um novo modo de exibio ou procedimento, voc deve chamar o mtodo Refresh da coleo de modos de exibio ou procedimentos para obter valores para as propriedades DateCreated e DateModified.

4.2 Nenhuma propriedade ParentCatalog para objetos de ndice

Na 'Ajuda' do ADOX, o ParentCatalog est listado incorretamente como uma propriedade de objetos de ndice. ParentCatalog , na verdade, uma propriedade de objetos de coluna e tabela somente.

4.3 adAccessRevoke sobrescreve o parmetro Rights de SetPermissions

Ao chamar o mtodo SetPermissions de um grupo ou usurio, a configurao do parmetro Actions para adAccessRevoke sobrescreve qualquer configurao do parmetro Rights. No defina Actions para adAccessRevoke se desejar que os direitos especificados no parmetro Rights sejam efetivos.

4.4 Parmetro RelatedColumn do mtodo Append (coleo de chaves)

A documentao do mtodo Append da coleo de chaves deveria incluir um quarto parmetro opcional chamado RelatedColumn. A sintaxe atualizada :

Keys.Append Key [, KeyType] [, Column] [, RelatedTable] [, RelatedColumn]

O parmetro RelatedColumn  opcional. O RelatedColumn  um valor de seqncia que especifica o nome da coluna relacionada para uma chave externa. O parmetro RelatedTable pode corresponder ao valor da propriedade Name de um objeto coluna.

4.5 Valor Enum de adIndexNullsAllow da propriedade IndexNulls

A documentao para a propriedade IndexNulls do objeto ndice deveria incluir uma ou mais constantes Enum na tabela de valores vlidos:

adIndexNullsAllow     O ndice permite entradas quando as colunas chave so nulas. Se um valor nulo  inserido em uma coluna chave, a entrada  inserida no ndice. 
