Podklíče specifikace ovladače

Každý ovladač uvedený v podklíči Ovladače ODBC má vlastní podklíč. Tento podklíč má stejný název jako odpovídající hodnota podklíčem Ovladače ODBC. Hodnoty pod tímto podklíčem uvádějí úplné cesty knihoven DLL ovladače a nastavení ovladačů, hodnoty klíčových slov ovladače vrácené sqlDrivery a počet využití. Formáty hodnot jsou uvedené v následující tabulce.

Název	Datový typ	Data
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	*.přípona souboru1[,*.file-extension2]...
FileUsage	REG_SZ	0 | 1 | 2
Nastavení	REG_SZ	setup-DLL-path
SQLLevel	REG_SZ	0 | 1 | 2
UsageCount	REG_DWORD	počet

Použití každého klíčového slova je zobrazeno v následující tabulce.

Keyword	Usage
APILevel	Číslo označující úroveň shody rozhraní ODBC podporovanou ovladačem: 0 = Žádné 1 = podpora úrovně 1 2 = podpora úrovně 2 Musí to být stejné jako hodnota vrácená pro možnost SQL_ODBC_INTERFACE_CONFORMANCE v SQLGetInfo.
CreateDSN	Název jednoho nebo více zdrojů dat, které se mají vytvořit při instalaci ovladače. Systémové informace musí obsahovat jeden oddíl specifikace zdroje dat pro každý zdroj dat uvedený s klíčovým slovem CreateDSN . Tyto části by neměly obsahovat klíčové slovo Ovladač , protože je zadáno v oddílu specifikace ovladače, ale musí obsahovat dostatek informací pro funkci ConfigDSN v knihovně DLL pro nastavení ovladače k vytvoření specifikace zdroje dat bez zobrazení dialogových oken. Formát oddílu specifikace zdroje dat najdete v části Podklíče specifikace zdroje dat.
ConnectFunctions	Řetězec se třemi znaky označující, zda ovladač podporuje SQLConnect, SQLDriverConnect a SQLBrowseConnect. Pokud ovladač podporuje SQLConnect, první znak je "Y"; jinak se jedná o "N". Pokud ovladač podporuje SQLDriverConnect, druhý znak je "Y"; jinak se jedná o "N". Pokud ovladač podporuje SQLBrowseConnect, třetí znak je "Y"; jinak se jedná o "N". Pokud například ovladač podporuje SQLConnect a SQLDriverConnect , ale ne SQLBrowseConnect, řetězec se třemi znaky je YYN.
DriverODBCVer	Řetězec znaků s verzí rozhraní ODBC, kterou ovladač podporuje. Verze je ve formátu nn.nn, kde první dvě číslice jsou hlavní verzí a další dvě číslice jsou podverze. Pro verzi rozhraní ODBC popsanou v této příručce musí ovladač vrátit hodnotu 03.00. Musí to být stejné jako hodnota vrácená pro možnost SQL_DRIVER_ODBC_VER v SQLGetInfo.
FileExtns	Pro ovladače založené na souborech je seznam přípon souborů, které může ovladač použít, oddělený čárkami. Například ovladač dBASE může zadat *.dbf a formátovaný textový soubor ovladač může zadat *.txt,*.csv. Příklad toho, jak může aplikace tyto informace používat, najdete v klíčovém slově FileUsage .
FileUsage	Číslo označující, jak ovladač založený na souborech přímo zpracovává soubory ve zdroji dat. 0 = Ovladač není ovladač založený na souborech. Například ovladač ORACLE je ovladač založený na DBMS. 1 = Ovladač založený na souborech zpracovává soubory ve zdroji dat jako tabulky. Například ovladač Xbase považuje každý soubor Xbase za tabulku. 2 = Ovladač založený na souborech zpracovává soubory ve zdroji dat jako katalog. Ovladač aplikace Microsoft Access například považuje každý soubor Aplikace Microsoft Access za úplnou databázi. Aplikace může tuto funkci použít k určení způsobu výběru dat uživateli. Uživatelé Xbase a Paradox si například často myslí data jako uložená v souborech, zatímco uživatelé ORACLE a Microsoft Access obecně považují data za uložená v tabulkách. Když uživatel v nabídce Soubor vybere Možnost Otevřít datový soubor, může aplikace zobrazit společné dialogové okno Otevřít soubor systému Windows. Seznam typů souborů by používal přípony souborů zadané pomocí klíčového slova FileExtns pro ovladače, které určují hodnotu FileUsage 1 a "Y" jako druhý znak hodnoty klíčového slova ConnectFunctions . Jakmile uživatel vybere soubor, aplikace zavolá SQLDriverConnect s klíčovým slovem DRIVER a pak spustí příkaz SELECT * FROM table-name . Když uživatel vybere možnost Importovat data z nabídky Soubor , může aplikace zobrazit seznam popisů pro ovladače, které určují hodnotu FileUsage 0 nebo 2 a "Y" jako druhý znak hodnoty klíčového slova ConnectFunctions . Jakmile uživatel vybere ovladač, aplikace bude volat SQLDriverConnect s klíčovým slovem DRIVER a pak zobrazit vlastní dialogové okno Vybrat tabulku .
SQLLevel	Číslo označující gramatiku SQL-92 podporovanou ovladačem: 0 = položka SQL-92 1 = FIPS127-2 Přechodné 2 = SQL-92 Intermediate 3 = ÚPLNÉ SQL-92 Musí to být stejné jako hodnota vrácená pro možnost SQL_SQL_CONFORMANCE v SQLGetInfo.

Informace o počtech využití najdete v části Počet využití v předchozí části.

Aplikace by neměly nastavit počet využití. Rozhraní ODBC bude tento počet udržovat.

Předpokládejme například, že ovladač formátovaných textových souborů má knihovnu DLL ovladače s názvem Text.dll, samostatnou instalační knihovnu DLL ovladače s názvem Txtsetup.dlla byla nainstalována třikrát. Pokud ovladač podporuje úroveň shody rozhraní API úrovně 1, podporuje úroveň minimální shody gramatiky SQL, považuje soubory za tabulky a může používat soubory s .txt a rozšířeními .csv, mohou být hodnoty podklíčem Text následující:

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