Delen via


Subsleutels voor specificaties van stuurprogramma

Elk stuurprogramma dat wordt vermeld in de subsleutel ODBC-stuurprogramma's heeft een eigen subsleutel. Deze subsleutel heeft dezelfde naam als de bijbehorende waarde onder de subsleutel ODBC-stuurprogramma's. De waarden onder deze subsleutel bevatten de volledige paden van de DLL's voor het instellen van stuurprogramma's en stuurprogramma's, de waarden van de trefwoorden van het stuurprogramma die door SQLDrivers worden geretourneerd en het aantal gebruiksgegevens. De notaties van de waarden worden weergegeven in de volgende tabel.

Naam Gegevenstype Gegevens
APILevel REG_SZ 0 | 1 | 2
ConnectFunctions REG_SZ {Y|N}{Y|N}{Y|N}
CreateDSN REG_SZ driver-description
Chauffeur REG_SZ driver-DLL-pad
DriverODBCVer REG_SZ nn.nn
FileExtns REG_SZ *.bestandsextensie1[,*.bestandsextensie2]...
FileUsage REG_SZ 0 | 1 | 2
Configuratie REG_SZ setup-DLL-pad
SQLLevel REG_SZ 0 | 1 | 2
UsageCount REG_DWORD aantal

Het gebruik van elk trefwoord wordt weergegeven in de volgende tabel.

Keyword Usage
APILevel Een getal dat het conformanceniveau van de ODBC-interface aangeeft dat wordt ondersteund door het stuurprogramma:

0 = Geen

1 = Ondersteund op niveau 1

2 = Ondersteund op niveau 2

Dit moet hetzelfde zijn als de waarde die wordt geretourneerd voor de optie SQL_ODBC_INTERFACE_CONFORMANCE in SQLGetInfo.
CreateDSN De naam van een of meer gegevensbronnen die moeten worden gemaakt wanneer het stuurprogramma is geïnstalleerd. De systeeminformatie moet één sectie met gegevensbronspecificatie bevatten voor elke gegevensbron die wordt vermeld met het trefwoord CreateDSN . Deze secties mogen het trefwoord Stuurprogramma niet bevatten, omdat dit is opgegeven in de sectie stuurprogrammaspecificatie, maar moet voldoende informatie bevatten voor de ConfigDSN-functie in het DLL-bestand voor het instellen van stuurprogramma's om een gegevensbronspecificatie te maken zonder dialoogvensters weer te geven. Zie Subsleutels voor gegevensbronspecificatie voor de indeling van een specificatiesectie voor gegevensbronnen.
ConnectFunctions Een tekenreeks met drie tekens die aangeeft of het stuurprogramma ONDERSTEUNING biedt voor SQLConnect, SQLDriverConnect en SQLBrowseConnect. Als het stuurprogramma SQLConnect ondersteunt, is het eerste teken 'Y'; anders is het 'N'. Als het stuurprogramma SQLDriverConnect ondersteunt, is het tweede teken 'Y'; anders is het 'N'. Als het stuurprogramma SQLBrowseConnect ondersteunt, is het derde teken 'Y'; anders is het 'N'. Als een stuurprogramma bijvoorbeeld ONDERSTEUNING biedt voor SQLConnect en SQLDriverConnect , maar niet SQLBrowseConnect, is de tekenreeks met drie tekens 'YYN'.
DriverODBCVer Een tekenreeks met de versie van ODBC die het stuurprogramma ondersteunt. De versie is van het formulier nn.nn, waarbij de eerste twee cijfers de primaire versie zijn en de volgende twee cijfers de secundaire versie zijn. Voor de versie van ODBC die in deze handleiding wordt beschreven, moet het stuurprogramma '03.00' retourneren.

Dit moet hetzelfde zijn als de waarde die wordt geretourneerd voor de optie SQL_DRIVER_ODBC_VER in SQLGetInfo.
FileExtns Voor stuurprogramma's op basis van bestanden kan het stuurprogramma een door komma's gescheiden lijst met extensies van de bestanden gebruiken. Een dBASE-stuurprogramma kan bijvoorbeeld *.dbf opgeven en een opgemaakt tekstbestandstuurprogramma kan *.txt,*.csvopgeven. Zie het trefwoord FileUsage voor een voorbeeld van hoe een toepassing deze informatie kan gebruiken.
FileUsage Een getal dat aangeeft hoe een stuurprogramma op basis van bestanden bestanden rechtstreeks behandelt in een gegevensbron.

0 = Het stuurprogramma is geen stuurprogramma op basis van bestanden. Een ORACLE-stuurprogramma is bijvoorbeeld een DBMS-stuurprogramma.

1 = Een stuurprogramma op basis van bestanden behandelt bestanden in een gegevensbron als tabellen. Een Xbase-stuurprogramma behandelt bijvoorbeeld elk Xbase-bestand als een tabel.

2 = Een stuurprogramma op basis van bestanden behandelt bestanden in een gegevensbron als een catalogus. Een Microsoft Access-stuurprogramma behandelt bijvoorbeeld elk Microsoft Access-bestand als een volledige database.

Een toepassing kan dit gebruiken om te bepalen hoe gebruikers gegevens selecteren. Xbase- en Paradox-gebruikers denken bijvoorbeeld vaak aan gegevens die zijn opgeslagen in bestanden, terwijl ORACLE- en Microsoft Access-gebruikers over het algemeen denken aan gegevens die zijn opgeslagen in tabellen.

Wanneer een gebruiker Open Data File selecteert in het menu Bestand , kan een toepassing het algemene dialoogvenster Windows-bestand openen weergeven. De lijst met bestandstypen gebruikt de bestandsextensies die zijn opgegeven met het sleutelwoord FileExtns voor stuurprogramma's die een FileUsage-waarde van 1 en Y opgeven als het tweede teken van de waarde van het trefwoord ConnectFunctions . Nadat de gebruiker een bestand heeft geselecteerd, roept de toepassing SQLDriverConnect aan met het trefwoord DRIVER en voert de instructie SELECT * FROM table name uit.

Wanneer de gebruiker Import Data selecteert in het menu Bestand , kan een toepassing een lijst met beschrijvingen weergeven voor stuurprogramma's die een FileUsage-waarde van 0 of 2 opgeven en 'Y' als het tweede teken van de waarde van het trefwoord ConnectFunctions . Nadat de gebruiker een stuurprogramma heeft geselecteerd, roept de toepassing SQLDriverConnect aan met het trefwoord DRIVER en wordt vervolgens een aangepast dialoogvenster Tabel selecteren weergegeven.
SQLLevel Een getal dat de SQL-92-grammatica aangeeft die wordt ondersteund door het stuurprogramma:

0 = SQL-92-vermelding

1 = FIPS127-2 Overgang

2 = SQL-92 Tussenliggend

3 = SQL-92 Full

Dit moet hetzelfde zijn als de waarde die wordt geretourneerd voor de optie SQL_SQL_CONFORMANCE in SQLGetInfo.

Zie Gebruik tellen eerder in deze sectie voor informatie over het aantal gebruiksgegevens.

Toepassingen mogen het gebruiksaantal niet instellen. ODBC behoudt dit aantal.

Stel dat een stuurprogramma voor opgemaakte tekstbestanden een STUURPROGRAMMA-DLL heeft met de naam Text.dll, een afzonderlijk DLL-bestand voor het instellen van stuurprogramma's met de naam Txtsetup.dllen drie keer is geïnstalleerd. Als het stuurprogramma ondersteuning biedt voor het nalevingsniveau van de Level 1-API, ondersteunt u het niveau van de minimale SQL-grammaticaconformance, behandelt u bestanden als tabellen en kunt u bestanden gebruiken met de extensies .txt en .csv, kunnen de waarden onder de subsleutel Text er als volgt uitzien:

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