Subclaves de la especificación del controlador
Cada controlador que aparece en la subclave Controladores ODBC tiene una subclave propia. Esta subclave tiene el mismo nombre que el valor correspondiente en la subclave Controladores ODBC. Los valores de esta subclave enumeran las rutas de acceso completas de los archivos DLL de configuración de controladores y controladores, los valores de las palabras clave del controlador devueltas por SQLDrivers y el recuento de uso. Los formatos de los valores se muestran en la tabla siguiente.
| Nombre | Tipo de datos | Data |
|---|---|---|
| APILevel | REG_SZ | 0 | 1 | 2 |
| ConnectFunctions | REG_SZ | {Y|N}{Y|N}{Y|N} |
| CreateDSN | REG_SZ | driver-description |
| Controlador | REG_SZ | driver-DLL-path |
| DriverODBCVer | REG_SZ | nn.nn |
| FileExtns | REG_SZ | *. file-extension1[,*. file-extension2]... |
| FileUsage | REG_SZ | 0 | 1 | 2 |
| Configurar | REG_SZ | setup-DLL-path |
| SQLLevel | REG_SZ | 0 | 1 | 2 |
| UsageCount | REG_DWORD | count |
El uso de cada palabra clave se muestra en la tabla siguiente.
| Palabra clave | Uso |
|---|---|
| APILevel | Número que indica el nivel de conformidad de la interfaz ODBC admitido por el controlador: 0 = Ninguna 1 = Nivel 1 admitido 2 = Nivel 2 admitido Debe ser el mismo que el valor devuelto para la opción SQL_ODBC_INTERFACE_CONFORMANCE en SQLGetInfo. |
| CreateDSN | Nombre de uno o varios orígenes de datos que se van a crear cuando se instala el controlador. La información del sistema debe incluir una sección de especificación de origen de datos para cada origen de datos enumerado con la palabra clave CreateDSN. Estas secciones no deben incluir la palabra clave Driver, ya que se especifica en la sección de especificación del controlador, pero deben incluir suficiente información para la función ConfigDSN en el archivo DLL de configuración del controlador para crear una especificación del origen de datos sin mostrar ningún cuadro de diálogo. Para obtener el formato de una sección de especificación de origen de datos, consulte Subclaves de la especificación del origen de datos. |
| ConnectFunctions | Cadena de tres caracteres que indica si el controlador admite SQLConnect, SQLDriverConnect y SQLBrowseConnect. Si el controlador admite SQLConnect, el primer carácter es "Y"; de lo contrario, es "N". Si el controlador admite SQLDriverConnect, el segundo carácter es "Y"; en caso contrario, es "N". Si el controlador admite SQLBrowseConnect, el tercer carácter es "Y"; en caso contrario, es "N". Por ejemplo, si un controlador admite SQLConnect y SQLDriverConnect, pero no SQLBrowseConnect, la cadena de tres caracteres es "YYN". |
| DriverODBCVer | Cadena de caracteres con la versión de ODBC que admite el controlador. La versión tiene la forma nn.nn, donde los dos primeros dígitos son la versión principal y los dos dígitos siguientes son la versión secundaria. Para la versión de ODBC descrita en este manual, el controlador debe devolver "03.00". Debe ser el mismo que el valor devuelto para la opción SQL_DRIVER_ODBC_VER en SQLGetInfo. |
| FileExtns | En el caso de los controladores basados en archivos, una lista separada por comas de las extensiones de los archivos que puede usar el controlador. Por ejemplo, un controlador dBASE podría especificar *.dbf y un controlador de archivo de texto con formato podría especificar *.txt,*.csv. Para obtener un ejemplo de cómo una aplicación podría usar esta información, consulte la palabra clave FileUsage. |
| FileUsage | Número que indica cómo un controlador basado en archivos trata directamente los archivos de un origen de datos. 0 = El controlador no es un controlador basado en archivos. Por ejemplo, un controlador ORACLE es un controlador basado en DBMS. 1 = Un controlador basado en archivos trata los archivos de un origen de datos como tablas. Por ejemplo, un controlador Xbase trata cada archivo Xbase como una tabla. 2 = Un controlador basado en archivos trata los archivos de un origen de datos como catálogo. Por ejemplo, un controlador de Microsoft Access trata cada archivo de Microsoft Access como una base de datos completa. Una aplicación puede usar esto para determinar cómo seleccionarán los datos los usuarios. Por ejemplo, los usuarios de Xbase y Paradox suelen pensar en datos como almacenados en archivos, mientras que los usuarios de ORACLE y Microsoft Access generalmente piensan en los datos como almacenados en tablas. Cuando un usuario selecciona Abrir archivo de datos en el menú Archivo, una aplicación podría mostrar el cuadro de diálogo Abrir archivo de Windows común. La lista de tipos de archivo usaría las extensiones de archivo especificadas con la palabra clave FileExtns para controladores que especifican un valor FileUsage de 1 e "Y" como segundo carácter del valor de la palabra clave ConnectFunctions. Una vez que el usuario selecciona un archivo, la aplicación llamaría a SQLDriverConnect con la palabra clave DRIVER y, a continuación, ejecutaría una instrucción SELECT * FROM table-name. Cuando el usuario selecciona Importar datos en el menú Archivo, una aplicación podría mostrar una lista de descripciones para los controladores que especifican un valor FileUsage de 0 o 2 e "Y" como segundo carácter del valor de la palabra clave ConnectFunctions. Una vez que el usuario selecciona un controlador, la aplicación llamaría a SQLDriverConnect con la palabra clave DRIVER y, a continuación, mostraría un cuadro de diálogo Seleccionar tabla personalizado. |
| SQLLevel | Número que indica la gramática de SQL-92 compatible con el controlador: 0 = Entrada de SQL-92 1 = FIPS127-2 Transitorio 2 = SQL-92 Intermedio 3 = SQL-92 Completo Debe ser el mismo que el valor devuelto para la opción SQL_SQL_CONFORMANCE en SQLGetInfo. |
Para obtener información sobre los recuentos de uso, consulte Recuento de usos más arriba en esta sección.
Las aplicaciones no deben establecer el recuento de uso. ODBC mantendrá este recuento.
Por ejemplo, supongamos que un controlador para archivos de texto con formato tiene un archivo DLL de controlador denominado Text.dll, un archivo DLL de instalación de controlador independiente denominado Txtsetup.dll y se ha instalado tres veces. Si el controlador admite el nivel de conformidad de la API de nivel 1, admite el nivel de conformidad de gramática mínima de SQL, trata los archivos como tablas y puede usar archivos con las extensiones .txt y .csv, los valores de la subclave Text pueden ser los siguientes:
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