Subchaves de especificação de driver
Cada driver listado na subchave Drivers ODBC tem uma subchave própria. Essa subchave tem o mesmo nome que o valor correspondente na subchave Drivers ODBC. Os valores nesta subchave listam os caminhos completos do driver e das DLLs de configuração do driver, os valores das palavras-chave do driver retornadas por SQLDrivers e a contagem de uso. Os formatos dos valores são mostrados na tabela a seguir.
| Nome | Tipo de dados | Dados |
|---|---|---|
| APILevel | REG_SZ | 0 | 1 | 2 |
| ConnectFunctions | REG_SZ | {Y N}{Y N}{Y|||N} |
| CreateDSN | REG_SZ | driver-description |
| Driver | REG_SZ | driver-DLL-caminho |
| DriverODBCVer | REG_SZ | nn.nn |
| FileExtns | REG_SZ | *. file-extension1[,*. file-extension2]... |
| FileUsage | REG_SZ | 0 | 1 | 2 |
| Instalação | REG_SZ | setup-DLL-path |
| SQLLevel | REG_SZ | 0 | 1 | 2 |
| UsageCount | REG_DWORD | count |
O uso de cada palavra-chave é mostrado na tabela a seguir.
| Palavra-chave | Uso |
|---|---|
| APILevel | Um número que indica o nível de conformidade da interface ODBC ao qual o driver dá suporte: 0 = Nenhum 1 = Nível 1 com suporte 2 = Nível 2 com suporte Deve ser igual ao valor retornado para a opção SQL_ODBC_INTERFACE_CONFORMANCE em SQLGetInfo. |
| CreateDSN | O nome de uma ou mais fontes de dados a serem criadas quando o driver for instalado. As informações do sistema devem incluir uma seção de especificação da origem de dados para cada origem de dados listada com a palavra-chave CreateDSN. Essas seções não devem incluir a palavra-chave Driver, pois ela é especificada na seção de especificação do driver, mas devem incluir informações suficientes para a função ConfigDSN na DLL de configuração do driver para criar uma fonte de dados especificação sem exibir nenhuma caixa de diálogo. Para obter o formato de uma seção de especificação de fonte de dados, consulte Subchaves de especificação de fonte de dados. |
| ConnectFunctions | Uma cadeia de caracteres com três caracteres que indica se o driver dá suporte a SQLConnect, SQLDriverConnect e SQLBrowseConnect. Se o driver der suporte a SQLConnect, o primeiro caractere será "Y"; caso contrário, será "N". Se o driver der suporte a SQLDriverConnect, o primeiro caractere será "Y"; caso contrário, será "N". Se o driver der suporte a SQLBrowseConnect, o terceiro caractere será "Y", caso contrário, será "N". Por exemplo, se um driver der suporte a SQLConnect e SQLDriverConnect, mas não a SQLBrowseConnect, a cadeia de caracteres de três caracteres será "YYN". |
| DriverODBCVer | Uma cadeia de caracteres com a versão do ODBC à qual o driver dá suporte. A versão tem o formato nn.nn, em que os dois primeiros dígitos são a versão principal e os próximos dois dígitos são a versão secundária. Para a versão do ODBC descrita neste manual o driver deverá retornar “03.00”. Deve ser igual ao valor retornado para a opção SQL_DRIVER_ODBC_VER em SQLGetInfo. |
| FileExtns | Para drivers com base em arquivo, uma lista separada por vírgulas de extensões dos arquivos que o driver pode usar. Por exemplo, um driver dBASE pode especificar *.dbf e um driver de arquivo de texto formatado pode especificar *.txt,*.csv. Para obter um exemplo de como um aplicativo pode usar essas informações, consulte a palavra-chave FileUsage. |
| FileUsage | Um número que indica como um driver com base em arquivo trata diretamente os arquivos em uma fonte de dados. 0 = O driver não é um driver com base em arquivo. Por exemplo, um driver ORACLE é um driver com base em DBMS. 1 = Um driver com base em arquivo trata os arquivos em uma fonte de dados como tabelas. Por exemplo, um driver Xbase trata cada arquivo Xbase como uma tabela. 2 = Um driver com base em arquivo trata os arquivos em uma fonte de dados como um catálogo. Por exemplo, um driver do Microsoft Access trata cada arquivo do Microsoft Access como um banco de dados completo. Um aplicativo pode usar isso para determinar como os usuários selecionarão os dados. Por exemplo, os usuários do Xbase e do Paradox geralmente pensam nos dados como armazenados em arquivos, enquanto os usuários do ORACLE e do Microsoft Access geralmente pensam nos dados como armazenados em tabelas. Quando um usuário seleciona Abrir arquivo de dados no menu Arquivo, um aplicativo pode exibir a caixa de diálogo comum Abrir arquivo do Windows. A lista de tipos de arquivo usaria as extensões de arquivo especificadas com a palavra-chave FileExtns para drivers que especificam um valor FileUsage de 1 e "Y" como o segundo caractere do valor da palavra-chave ConnectFunctions. Depois que o usuário seleciona um arquivo, o aplicativo chama SQLDriverConnect com a palavra-chave DRIVER e, em seguida, executa uma instrução SELECT * FROM table-name. Quando o usuário seleciona Importar dados no menu Arquivo, um aplicativo pode exibir uma lista de descrições para drivers que especificam um valor FileUsage de 0 ou 2 e "Y" como o segundo caractere do valor da palavra-chave ConnectFunctions. Depois que o usuário seleciona um driver, o aplicativo chama SQLDriverConnect com a palavra-chave DRIVER e exibe uma caixa de diálogo Selecionar Tabela personalizada. |
| SQLLevel | Um número que indica a gramática SQL-92 à qual o driver dá suporte: 0 = Entrada SQL-92 1 = FIPS127-2 Transitório 2 = SQL-92 Intermediário 3 = SQL-92 Completo Deve ser igual ao valor retornado para a opção SQL_SQL_CONFORMANCE em SQLGetInfo. |
Para obter informações sobre contagens de uso, consulte Contagem de uso anteriormente nesta seção.
Os aplicativos não devem definir a contagem de uso. O ODBC manterá essa contagem.
Por exemplo, suponha que um driver para arquivos de texto formatados tenha uma DLL de driver chamada Text.dll, uma DLL de configuração de driver separada chamada Txtsetup.dll e tenha sido instalado três vezes. Se o driver der suporte ao nível de conformidade da API Nível 1, der suporte ao nível mínimo de conformidade da gramática SQL, tratar os arquivos como tabelas e puder usar arquivos com as extensões.txt e.csv, os valores na subchave Text poderão ser os seguintes:
APILevel : REG_SZ : 1
ConnectFunctions : REG_SZ : YYN
Driver : REG_SZ : C:\WINDOWS\SYSTEM32\TEXT.DLL
DriverODBCVer : REG_SZ : 03.00.00
FileExtns : REG_SZ : *.txt,*.csv
FileUsage : REG_SZ : 1
Setup : REG_SZ : C:\WINDOWS\SYSTEM32\TXTSETUP.DLL
SQLLevel : REG_SZ : 0
UsageCount : REG_DWORD : 0x3