Undernycklar för drivrutinsspecifikation

Varje drivrutin som anges i undernyckeln ODBC-drivrutiner har en egen undernyckel. Den här undernyckeln har samma namn som motsvarande värde under undernyckeln ODBC-drivrutiner. Värdena under den här undernyckeln visar de fullständiga sökvägarna för drivrutins- och drivrutinskonfigurations-DLL:er, värdena för drivrutinsnyckelorden som returneras av SQLDrivers och användningsantalet. Formaten för värdena visas i följande tabell.

Namn	Datatyp	Uppgifter
APILevel	REG_SZ	0 | 1 | 2
ConnectFunctions	REG_SZ	{Y|N}{Y|N}{Y|N}
CreateDSN	REG_SZ	drivrutinsbeskrivning
Driver	REG_SZ	driver-DLL-path
DriverODBCVer	REG_SZ	nn.nn
FileExtns	REG_SZ	*.file-extension1[,*.file-extension2]...
FileUsage	REG_SZ	0 | 1 | 2
Inställningar	REG_SZ	setup-DLL-path
SQLLevel	REG_SZ	0 | 1 | 2
UsageCount	REG_DWORD	antal

Användningen av varje nyckelord visas i följande tabell.

Keyword	Usage
APILevel	Ett tal som anger den ODBC-gränssnittsefterlevnadsnivå som stöds av drivrutinen: 0 = Inga 1 = Nivå 1 stöds 2 = Nivå 2 stöds Detta måste vara samma som värdet som returneras för alternativet SQL_ODBC_INTERFACE_CONFORMANCE i SQLGetInfo.
CreateDSN	Namnet på en eller flera datakällor som ska skapas när drivrutinen installeras. Systeminformationen måste innehålla ett avsnitt för datakällans specifikation för varje datakälla som anges med nyckelordet CreateDSN . De här avsnitten bör inte innehålla nyckelordet Drivrutin eftersom detta anges i avsnittet för drivrutinsspecifikation, men måste innehålla tillräckligt med information för funktionen ConfigDSN i drivrutinskonfigurationens DLL för att skapa en specifikation för datakällan utan att visa några dialogrutor. Information om formatet för en datakällas specifikationsavsnitt finns i Undernycklar för datakällans specifikation.
ConnectFunctions	En sträng med tre tecken som anger om drivrutinen stöder SQLConnect, SQLDriverConnect och SQLBrowseConnect. Om drivrutinen stöder SQLConnect är det första tecknet "Y"; annars är det "N". Om drivrutinen stöder SQLDriverConnect är det andra tecknet "Y"; annars är det "N". Om drivrutinen stöder SQLBrowseConnect är det tredje tecknet "Y"; annars är det "N". Om en drivrutin till exempel stöder SQLConnect och SQLDriverConnect men inte SQLBrowseConnect är strängen med tre tecken "YYN".
DriverODBCVer	En teckensträng med den version av ODBC som drivrutinen stöder. Versionen är av formatet nn.nn, där de två första siffrorna är huvudversionen och de följande två siffrorna är delversionen. För den version av ODBC som beskrivs i den här handboken måste drivrutinen returnera "03.00". Detta måste vara samma som värdet som returnerades för alternativet SQL_DRIVER_ODBC_VER i SQLGetInfo.
FileExtns	För filbaserade drivrutiner, en kommaavgränsad lista över tillägg för de filer som drivrutinen kan använda. En dBASE-drivrutin kan till exempel ange *.dbf och en formaterad textfildrivrutin kan ange *.txt,*.csv. Ett exempel på hur ett program kan använda den här informationen finns i nyckelordet FileUsage .
FileUsage	Ett tal som anger hur en filbaserad drivrutin direkt behandlar filer i en datakälla. 0 = Drivrutinen är inte en filbaserad drivrutin. En ORACLE-drivrutin är till exempel en DBMS-baserad drivrutin. 1 = En filbaserad drivrutin behandlar filer i en datakälla som tabeller. En Xbase-drivrutin behandlar till exempel varje Xbase-fil som en tabell. 2 = En filbaserad drivrutin behandlar filer i en datakälla som en katalog. En Microsoft Access-drivrutin behandlar till exempel varje Microsoft Access-fil som en fullständig databas. Ett program kan använda detta för att avgöra hur användarna ska välja data. Till exempel tänker Xbase- och Paradox-användare ofta på data som lagrade i filer, medan ORACLE- och Microsoft Access-användare vanligtvis tänker på data som lagrade i tabeller. När en användare väljer Öppna datafil på menyn Arkiv kan ett program visa dialogrutan Öppna windows-fil . Listan över filtyper använder filnamnstilläggen som anges med nyckelordet FileExtns för drivrutiner som anger värdet FileUsage 1 och "Y" som det andra tecknet för värdet för nyckelordet ConnectFunctions . När användaren har valt en fil anropar programmet SQLDriverConnect med nyckelordet DRIVER och kör sedan instruktionen SELECT * FROM table-name . När användaren väljer Importera data från menyn Arkiv kan ett program visa en lista med beskrivningar för drivrutiner som anger värdet FileUsage 0 eller 2 och "Y" som det andra tecknet för värdet för nyckelordet ConnectFunctions . När användaren har valt en drivrutin anropar programmet SQLDriverConnect med nyckelordet DRIVER och visar sedan en anpassad dialogruta för Välj tabell .
SQLLevel	Ett tal som anger den SQL-92-grammatik som stöds av drivrutinen: 0 = SQL-92-post 1 = övergångsbestämt FIPS127-2 2 = SQL-92 Intermediate 3 = FULLSTÄNDIG SQL-92 Detta måste vara samma som värdet som returneras för alternativet SQL_SQL_CONFORMANCE i SQLGetInfo.

Information om användningsantal finns i Användningsräkning tidigare i det här avsnittet.

Program bör inte ange användningsantalet. ODBC behåller det här antalet.

Anta till exempel att en drivrutin för formaterade textfiler har en drivrutins-DLL med namnet Text.dll, en separat drivrutinsinstallations-DLL med namnet Txtsetup.dlloch har installerats tre gånger. Om drivrutinen stöder nivå 1 API-överensstämmelsenivå, stöder den lägsta SQL-grammatikens överensstämmelsenivå, behandlar filer som tabeller och kan använda filer med .txt och .csv tillägg, kan värdena under textundernyckeln vara följande:

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