Subchaves de especificação do driver

Cada driver listado na subchave ODBC Drivers tem uma subchave própria. Esta subchave tem o mesmo nome do valor correspondente sob a subchave ODBC Drivers. Os valores sob esta subchave listam os caminhos completos do driver e das DLLs de configuração do driver, os valores das palavras-chave do driver devolvidas pelo SQLDrivers e a contagem de utilização. Os formatos dos valores são os apresentados na tabela seguinte.

Nome	Tipo de dados	Data
APILevel	REG_SZ	0 | 1 | 2
ConnectFunctions	REG_SZ	{Y|N}{Y|N}{Y|N}
CreateDSN	REG_SZ	Descrição do piloto
Driver	REG_SZ	driver-DLL-path
DriverODBCVer	REG_SZ	nn.nn
FileExtns	REG_SZ	*.extensão1[,*.extensão-ficheiro2]...
Utilização de ficheiros	REG_SZ	0 | 1 | 2
Configuração	REG_SZ	Caminho-DLL de configuração
SQLLevel	REG_SZ	0 | 1 | 2
Contagem de Utilização	REG_DWORD	count

A utilização de cada palavra-chave é mostrada na tabela seguinte.

Keyword	Usage
APILevel	Um número que indica o nível de conformidade da interface ODBC suportado pelo driver: 0 = Nenhum 1 = Nível 1 suportado 2 = Nível 2 suportado Isto deve ser o mesmo valor devolvido para a opção SQL_ODBC_INTERFACE_CONFORMANCE no SQLGetInfo.
CreateDSN	O nome de uma ou mais fontes de dados a serem criadas quando o driver é instalado. A informação do sistema deve incluir uma secção de especificação de fonte de dados para cada fonte listada com a palavra-chave CreateDSN . Estas secções não devem incluir a palavra-chave Driver , pois esta está especificada na secção de especificação do driver, mas devem incluir informação suficiente para que a função ConfigDSN na DLL de configuração do driver crie uma especificação de fonte de dados sem exibir quaisquer caixas de diálogo. Para o formato de uma secção de especificação de fonte de dados, consulte Subchaves de Especificação de Fonte de Dados.
ConnectFunctions	Uma cadeia de três caracteres que indica se o driver suporta SQLConnect, SQLDriverConnect e SQLBrowseConnect. Se o driver suportar SQLConnect, o primeiro carácter é "Y"; caso contrário, é "N". Se o driver suportar SQLDriverConnect, o segundo carácter é "Y"; caso contrário, é "N". Se o driver suportar SQLBrowseConnect, o terceiro carácter é "Y"; caso contrário, é "N". Por exemplo, se um driver suporta SQLConnect e SQLDriverConnect mas não SQLBrowseConnect, a cadeia de três caracteres é "YYN".
DriverODBCVer	Uma cadeia de caracteres com a versão do ODBC que o driver suporta. A versão é da forma nn.nn, onde os dois primeiros dígitos são a versão maior e os dois dígitos seguintes a versão menor. Para a versão do ODBC descrita neste manual, o driver deve devolver "03.00". Isto deve ser o mesmo que o valor devolvido para a opção SQL_DRIVER_ODBC_VER no SQLGetInfo.
FileExtns	Para drivers baseados em ficheiros, uma lista separada por vírgulas das extensões dos ficheiros que o driver pode usar. Por exemplo, um driver dBASE pode especificar *.dbf e um driver de ficheiro de texto formatado pode especificar *.txt,*.csv. Para um exemplo de como uma aplicação pode usar esta informação, consulte a palavra-chave FileUsage .
Utilização de ficheiros	Um número que indica como um driver baseado em ficheiros trata diretamente os ficheiros numa fonte de dados. 0 = O driver não é baseado em ficheiros. Por exemplo, um driver ORACLE é um driver baseado em SGBD. 1 = Um driver baseado em ficheiros trata os ficheiros numa fonte de dados como tabelas. Por exemplo, um driver Xbase trata cada ficheiro Xbase como uma tabela. 2 = Um driver baseado em ficheiros trata os ficheiros numa fonte de dados como um catálogo. Por exemplo, um driver do Microsoft Access trata cada ficheiro do Microsoft Access como uma base de dados completa. Uma aplicação pode usar isto para determinar como os utilizadores vão selecionar os dados. Por exemplo, os utilizadores do Xbase e Paradox costumam pensar nos dados como armazenados em ficheiros, enquanto os utilizadores do ORACLE e do Microsoft Access geralmente pensam nos dados como armazenados em tabelas. Quando um utilizador seleciona Abrir Ficheiro de Dados no menu Ficheiro , uma aplicação pode mostrar a caixa de diálogo comum do Windows Ficheiro Aberto . A lista de tipos de ficheiros usaria as extensões de ficheiro especificadas com a palavra-chave FileExtns para drivers que especificam um valor FileUsage de 1 e "Y" como o segundo carácter do valor da palavra-chave ConnectFunctions . Depois de o utilizador selecionar um ficheiro, a aplicação chamaria o SQLDriverConnect com a palavra-chave DRIVER e depois executaria a instrução SELECT * FROM de nome da tabela . Quando o utilizador seleciona Importar Dados no menu Ficheiro , uma aplicação pode mostrar uma lista de descrições de drivers que especificam um valor de FileUsage de 0 ou 2, e "Y" como o segundo carácter do valor da palavra-chave ConnectFunctions . Depois de o utilizador selecionar um driver, a aplicação chamaria o SQLDriverConnect com a palavra-chave DRIVER e depois exibiria uma caixa de diálogo personalizada de Select Table .
SQLLevel	Um número que indica a gramática SQL-92 suportada pelo driver: 0 = Entrada SQL-92 1 = FIPS127-2 Transição 2 = SQL-92 Intermédio 3 = SQL-92 Full Isto deve ser o mesmo valor devolvido para a opção SQL_SQL_CONFORMANCE em SQLGetInfo.

Para informações sobre contagens de utilização, consulte Contagem de Utilização anteriormente nesta secção.

As aplicações não devem definir a contagem de utilizações. O ODBC manterá esta contagem.

Por exemplo, suponha que um driver para ficheiros de texto formatados tem uma DLL de driver chamada Text.dll, uma DLL de configuração de driver separada chamada Txtsetup.dll, e que foi instalado três vezes. Se o driver suportar o nível de conformidade com a API de Nível 1, suportar o nível de conformidade gramatical Minimal SQL, tratar ficheiros como tabelas e puder usar ficheiros com as extensões .txt e .csv, os valores sob a subchave Texto podem 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