Sous-clés de spécification de pilote

Chaque pilote répertorié dans la sous-clé Pilotes ODBC possède sa propre sous-clé. Cette sous-clé porte le même nom que la valeur correspondante de la sous-clé Pilotes ODBC. Les valeurs de cette sous-clé indiquent les chemins complets du pilote et des DLL d'installation du pilote, les valeurs des mots-clés du pilote renvoyés par SQLDrivers et le nombre d'utilisations. Les formats des valeurs sont indiqués dans le tableau suivant.

Name	Type de données	Données
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-path
DriverODBCVer	REG_SZ	nn.nn
FileExtns	REG_SZ	*. file-extension1[,*. file-extension2]...
FileUsage	REG_SZ	0 | 1 | 2
Programme d'installation	REG_SZ	setup-DLL-path
SQLLevel	REG_SZ	0 | 1 | 2
UsageCount	REG_DWORD	count

L'utilisation de chaque mot clé est indiquée dans le tableau suivant.

Mot clé	Utilisation
APILevel	Nombre indiquant le niveau de conformité de l'interface ODBC pris en charge par le pilote : 0 = Aucun(e) 1 = Niveau 1 pris en charge 2 = Niveau 2 pris en charge Elle doit être identique à la valeur renvoyée pour l'option SQL_ODBC_INTERFACE_CONFORMANCE dans SQLGetInfo.
CreateDSN	Nom d'une ou plusieurs sources de données à créer lors de l'installation du pilote. Les System Information doivent inclure une section de spécification de source de données pour chaque source de données répertoriée avec le mot clé CreateDSN. Ces sections ne doivent pas inclure le mot-clé Driver, car il est spécifié dans la section de spécification du driver. En revanche, elles doivent contenir suffisamment d'informations pour que la fonction ConfigDSN de la DLL d'installation du driver puisse créer une spécification de source de données sans afficher des zones de dialogue. Pour connaître le format d'une section de spécification de source de données, consultez les sous-clés de spécification de source de données.
ConnectFunctions	Chaîne à trois caractères indiquant si le pilote prend en charge SQL Connecter, SQLDriver Connecter et SQLBrowse Connecter. Si le pilote prend en charge SQLConnect, le premier caractère est « Y ». Dans le cas contraire, il sera « N ». Si le pilote prend en charge SQLDriverConnect, le deuxième caractère est « Y ». Dans le cas contraire, il sera « N ». Si le pilote prend en charge SQLBrowseConnect, le troisième caractère est « Y ». Dans le cas contraire, il sera « N ». Par exemple, si un pilote prend en charge SQLConnect et SQLDriverConnect par opposition à SQLBrowseConnect, la chaîne à trois caractères est « YYN ».
DriverODBCVer	Chaîne de caractères avec la version d'ODBC prise en charge par le pilote. Cette version se présente sous la forme nn.nn, où les deux premiers chiffres correspondent à la version principale et les deux suivants à la version mineure. Pour la version d'ODBC décrite dans ce manuel, le pilote doit retourner « 03.00 ». Elle doit être identique à la valeur renvoyée pour l'option SQL_DRIVER_ODBC_VER dans SQLGetInfo.
FileExtns	Pour les pilotes basés sur des fichiers, une liste d'extensions séparées par des virgules pour les fichiers que le pilote peut utiliser. Par exemple, un pilote dBASE peut spécifier *.dbf et un pilote de fichier texte mis en forme peut spécifier *.txt,*.csv. Pour un exemple d'utilisation de ces informations par une application, consultez le mot-clé FileUsage.
FileUsage	Nombre indiquant la manière dont un pilote basé sur les fichiers traite directement les fichiers dans une source de données. 0 = Le pilote n'est pas un pilote basé sur des fichiers. Par exemple, un pilote ORACLE est un pilote SGBD. 1 = Un pilote basé sur des fichiers traite les fichiers d'une source de données en tant que tables. Par exemple, un pilote Xbase traite chaque fichier Xbase en tant que table. 2 = Un pilote basé sur des fichiers traite les fichiers d'une source de données en tant que catalogue. Par exemple, un pilote Microsoft Access traite chaque fichier Microsoft Access en tant que base de données complète. Une application peut l'utiliser pour déterminer la façon dont les utilisateurs sélectionnent des données. Par exemple, les utilisateurs de Xbase et de Paradox considèrent généralement que les données sont stockées dans des fichiers. Par contre, les utilisateurs d'ORACLE et de Microsoft Access considèrent généralement que les données sont stockées dans des tables. Lorsqu'un utilisateur sélectionne Ouvrir un fichier de données dans le menu Fichier, une application peut afficher la zone de dialogue commune d'ouverture de fichier de Windows. La liste des types de fichiers utilise les extensions de fichiers spécifiées avec le mot-clé FileExtns pour les pilotes qui spécifient une valeur FileUsage de 1 et « Y » comme deuxième caractère de la valeur du mot-clé ConnectFunctions. Une fois que l'utilisateur a sélectionné un fichier, l'application appelle SQLDriverConnect avec le mot-clé DRIVER, puis exécute une instruction SELECT * FROM table-name. Lorsque l'utilisateur sélectionne Importer des données dans le menu Fichier, une application pourrait afficher une liste de descriptions pour les pilotes qui spécifient une valeur FileUsage de 0 ou 2, et « Y » comme deuxième caractère de la valeur du mot-clé ConnectFunctions. Une fois que l'utilisateur a sélectionné un pilote, l'application appelle SQLDriverConnect avec le mot-clé DRIVER, puis affiche une zone de dialogue personnalisée Select Table.
SQLLevel	Nombre indiquant la grammaire SQL-92 prise en charge par le pilote : 0 = Entrée SQL-92 1 = FIPS127-2 Transitionnelle 2 = SQL-92 Intermédiaire 3 = SQL-92 Complet Cette valeur doit être la même que celle renvoyée pour l'option SQL_SQL_CONFORMANCE dans SQLGetInfo.

Pour plus d'informations sur le nombre d'utilisation, consultez Nombre d'utilisation plus haut dans cette section.

Les applications ne doivent pas définir le nombre d'utilisations. ODBC conservera ce nombre.

Par exemple, supposons qu'un pilote pour les fichiers texte mis en forme possède une DLL de pilote nommée Text.dll, une DLL d'installation de pilote séparée nommée Txtsetup.dll, et qu'il ait été installé trois fois. Si le pilote prend en charge le niveau 1 de conformité de l'API, le niveau minimum de conformité de la grammaire SQL, traite les fichiers comme des tables et peut utiliser des fichiers avec les extensions .txt et .csv, les valeurs de la sous-clé Texte peuvent être les suivantes :

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