Alkulcsok az illesztőprogram-specifikációhoz

Az ODBC-illesztőprogramok alkulcsában felsorolt összes illesztőprogramnak saját alkulcsa van. Ennek az alkulcsnak ugyanaz a neve, mint az ODBC-illesztőprogramok alkulcsában lévő megfelelő értéknek. Az alkulcs alatti értékek az illesztőprogram és az illesztőprogram beállítási DLL-jeinek teljes elérési útját, az SQLDrivers által visszaadott illesztőprogram-kulcsszavak értékeit és a használat számát sorolják fel. Az értékek formátuma az alábbi táblázatban látható.

Név	Adattípus	Adat
APILevel	REG_SZ	0 | 1 | 2
ConnectFunctions	REG_SZ	{Y|N}{Y|N}{Y|N}
CreateDSN	REG_SZ	illesztőprogram leírása
Driver	REG_SZ	driver-DLL-path
DriverODBCVer	REG_SZ	nn.nn
FileExtns	REG_SZ	*.file-extension1[,*.file-extension2]...
FileUsage	REG_SZ	0 | 1 | 2
Beállítás	REG_SZ	setup-DLL-path
SQLLevel	REG_SZ	0 | 1 | 2
UsageCount	REG_DWORD	count

Az egyes kulcsszavak használata az alábbi táblázatban látható.

Keyword	Usage
APILevel	Az illesztő által támogatott ODBC-illesztő-megfelelőségi szintet jelző szám: 0 = Nincs 1 = 1. szint támogatott 2 = 2. szint támogatott Ennek meg kell egyeznie az SQLGetInfo SQL_ODBC_INTERFACE_CONFORMANCE beállításának visszaadott értékével.
CreateDSN	Az illesztőprogram telepítésekor létrehozandó egy vagy több adatforrás neve. A rendszerinformációknak tartalmazniuk kell egy adatforrás-specifikációs szakaszt a CreateDSN kulcsszóval felsorolt adatforrásokhoz. Ezek a szakaszok nem tartalmazhatják az illesztőprogram kulcsszóját, mert ez az illesztőprogram specifikációs szakaszában van megadva, de elegendő információt kell tartalmaznia ahhoz, hogy az illesztőprogram telepítő DLL-jében a ConfigDSN függvény egy adatforrás-specifikációt hozzon létre párbeszédpanelek megjelenítése nélkül. Az adatforrás specifikációs szakaszának formátumát az Adatforrás specifikációja alkulcsok című témakörben találja.
ConnectFunctions	Három karakterből álló sztring, amely jelzi, hogy az illesztőprogram támogatja-e az SQLConnectet, az SQLDriverConnectet és az SQLBrowseConnectet. Ha az illesztőprogram támogatja az SQLConnectet, az első karakter az "Y"; ellenkező esetben ez "N". Ha az illesztőprogram támogatja az SQLDriverConnectet, a második karakter az "Y"; ellenkező esetben ez "N". Ha az illesztőprogram támogatja az SQLBrowseConnectet, a harmadik karakter az "Y"; ellenkező esetben ez "N". Ha például egy illesztő támogatja az SQLConnectet és az SQLDriverConnectet , de az SQLBrowseConnectet nem, a három karakterből álló sztring az "YYN".
DriverODBCVer	Az illesztőprogram által támogatott ODBC-verziójú karaktersztring. A verzió az nn.nn formátumú, ahol az első két számjegy a főverzió, a következő két számjegy pedig az alverzió. Az ODBC jelen kézikönyvben leírt verziójához az illesztőprogramnak a "03.00" értéket kell visszaadnia. Ennek meg kell egyeznie az SQLGetInfo SQL_DRIVER_ODBC_VER beállításának visszaadott értékével.
FileExtns	Fájlalapú illesztőprogramok esetén az illesztőprogram által használható fájlok bővítményeinek vesszővel tagolt listája. Egy dBASE-illesztő például *.dbf értéket adhat meg, a formázott szövegfájl-illesztő pedig *.txt,*.csv. Egy példa arra, hogy egy alkalmazás hogyan használhatja ezeket az információkat, tekintse meg a FileUsage kulcsszót .
FileUsage	Egy szám, amely azt jelzi, hogy egy fájlalapú illesztőprogram hogyan kezeli közvetlenül az adatforrás fájljait. 0 = Az illesztőprogram nem fájlalapú illesztőprogram. Az ORACLE-illesztőprogram például egy DBMS-alapú illesztőprogram. 1 = A fájlalapú illesztőprogramok táblákként kezelik az adatforrásban lévő fájlokat. Egy Xbase-illesztő például táblázatként kezeli az egyes Xbase-fájlokat. 2 = A fájlalapú illesztőprogramok katalógusként kezelik az adatforrásban lévő fájlokat. Egy Microsoft Access-illesztő például az egyes Microsoft Access-fájlokat teljes adatbázisként kezeli. Egy alkalmazás ezt használhatja annak meghatározására, hogy a felhasználók hogyan fogják kiválasztani az adatokat. Az Xbase és a Paradox felhasználói például gyakran fájlokban tárolt adatokként tekintenek az adatokra, míg az ORACLE és a Microsoft Access felhasználói általában a táblákban tárolt adatokra gondolnak. Amikor egy felhasználó az Adatfájl megnyitása lehetőséget választja a Fájl menüből, az alkalmazás megjelenítheti a Windows Fájl megnyitása közös párbeszédpanelt. A fájltípusok listája a FileExtns kulcsszóval megadott fájlkiterjesztéseket használja az illesztőprogramokhoz, amelyek a ConnectFunctions kulcsszó értékének második karaktereként 1 és Y FileUsage értéket ad meg. Miután a felhasználó kiválasztott egy fájlt, az alkalmazás meghívja az SQLDriverConnect-et a DRIVER kulcsszóval, majd végrehajt egy SELECT * FROM táblanév utasítást. Amikor a felhasználó az Adatok importálása lehetőséget választja a Fájl menüből, az alkalmazás megjelenítheti a 0 vagy 2 FileUsage értéket megadó illesztőprogramok leírását, az "Y" pedig a ConnectFunctions kulcsszó értékének második karakterét. Miután a felhasználó kiválasztott egy illesztőprogramot, az alkalmazás meghívja az SQLDriverConnectet az ILLESZTŐPROGRAM kulcsszóval, majd megjelenít egy egyéni Tábla kiválasztása párbeszédpanelt.
SQLLevel	Az illesztő által támogatott SQL-92 nyelvhelyességet jelző szám: 0 = SQL-92 bejegyzés 1 = FIPS127-2 Átmeneti 2 = SQL-92 Köztes 3 = SQL-92 Teljes Ennek meg kell egyeznie az SQLGetInfo SQL_SQL_CONFORMANCE beállításának visszaadott értékével.

A használatok számáról a jelen szakasz korábbi, Használatszámlálás című szakaszában olvashat bővebben.

Az alkalmazások nem állíthatják be a használat számát. Az ODBC fenntartja ezt a számot.

Tegyük fel például, hogy a formázott szövegfájlok illesztőprogramja rendelkezik egy Text.dllnevű illesztőprogram-DLL-sel, egy külön Txtsetup.dllnevű illesztőprogram-telepítő DLL-sel, és háromszor lett telepítve. Ha az illesztő támogatja az 1. szintű API-megfelelőségi szintet, támogatja a minimális SQL-nyelvhelyességi megfelelőséget, táblákként kezeli a fájlokat, és használhat fájlokat a .txt és .csv bővítményekkel, a Szöveg alkulcs alatti értékek a következők lehetnek:

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