Sottochiavi di specifica del driver
Ogni driver elencato nella sottochiave Driver ODBC ha una propria sottochiave. Questa sottochiave ha lo stesso nome del valore corrispondente nella sottochiave Driver ODBC. I valori sotto questa sottochiave elencano i percorsi completi delle DLL del driver e di impostazione del driver, i valori delle parole chiave del driver restituite da SQLDrivers e il conteggio dell'utilizzo. I formati dei valori sono indicati nella seguente tabella.
| Nome | Tipo di dati | Dati |
|---|---|---|
| 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 |
| Attrezzaggio | REG_SZ | setup-DLL-path |
| SQLLevel | REG_SZ | 0 | 1 | 2 |
| UsageCount | REG_DWORD | count |
L'uso di ciascuna parola chiave è illustrato nella tabella seguente.
| Parola chiave | Utilizzo |
|---|---|
| APILevel | Un numero che indica il livello di conformità dell'interfaccia ODBC supportato dal driver: 0 = Nessuna 1 = Livello 1 supportato 2 = Livello 2 supportato Deve essere uguale al valore restituito per l'opzione SQL_ODBC_INTERFACE_CONFORMANCE in SQLGetInfo. |
| CreateDSN | Il nome di una o più origini dati da creare quando il driver è installato. Le informazioni di sistema devono includere una sezione di specifica dell'origine dati per ogni origine dati elencata con la parola chiave CreateDSN. Queste sezioni non devono includere la parola chiave Driver, perché è specificata nella sezione delle specifiche del driver, ma devono includere informazioni sufficienti affinché la funzione ConfigDSN nella DLL di configurazione del driver crei una specifica dell'origine dati senza visualizzare alcuna finestra di dialogo. Per il formato di una sezione di specifica dell'origine dati, vedere Sottochiavi di specifica dell'origine dati. |
| ConnectFunctions | Una stringa di tre caratteri che indica se il driver supporta SQLConnect, SQLDriverConnect e SQLBrowseConnect. Se il driver supporta SQLConnect, il primo carattere è "Y", altrimenti è "N". Se il driver supporta SQLDriverConnect, il secondo carattere è "Y", altrimenti è "N". Se il driver supporta SQLBrowseConnect, il terzo carattere è "Y", altrimenti è "N". Ad esempio, se un driver supporta SQLConnect e SQLDriverConnect ma non SQLBrowseConnect, la stringa a tre caratteri è "YYN". |
| DriverODBCVer | Una stringa di caratteri con la versione di ODBC supportata dal driver. La versione è nel formato nn.nn, dove le prime due cifre sono la versione principale e le due successive la versione secondaria. Per la versione di ODBC descritta in questo manuale, il driver deve restituire "03.00". Deve corrispondere al valore restituito per l'opzione SQL_DRIVER_ODBC_VER in SQLGetInfo. |
| FileExtns | Per i driver basati su file, un elenco separato da virgole delle estensioni dei file che il driver può utilizzare. Ad esempio, un driver dBASE può specificare *.dbf e un driver per file di testo formattato può specificare *.txt, *.csv. Per un esempio di come un'applicazione potrebbe utilizzare queste informazioni, vedere la parola chiave FileUsage. |
| FileUsage | Un numero che indica come un driver basato su file tratta direttamente i file in un'origine dati. 0 = Il driver non è un driver basato su file. Ad esempio, un driver ORACLE è un driver basato su DBMS. 1 = Un driver basato su file tratta i file di un'origine dati come tabelle. Ad esempio, un driver Xbase tratta ogni file Xbase come una tabella. 2 = Un driver basato su file tratta i file di un'origine dati come un catalogo. Ad esempio, un driver di Microsoft Access tratta ogni file Microsoft Access come un database completo. Un'applicazione potrebbe utilizzarla per determinare il modo in cui gli utenti selezioneranno i dati. Ad esempio, gli utenti di Xbase e Paradox pensano spesso ai dati come se fossero archiviati in file, mentre gli utenti di ORACLE e Microsoft Access pensano generalmente ai dati come se fossero archiviati in tabelle. Quando un utente seleziona Apri file di dati dal menu File, un'applicazione potrebbe visualizzare la finestra di dialogo comune di Windows File Open. L'elenco dei tipi di file utilizzerebbe le estensioni dei file specificate con la parola chiave FileExtns per i driver che specificano un valore FileUsage di 1 e "Y" come secondo carattere del valore della parola chiave ConnectFunctions. Dopo che l'utente ha selezionato un file, l'applicazione chiama SQLDriverConnect con la parola chiave DRIVER e poi esegue un'istruzione SELECT * FROM table-name. Quando l'utente seleziona Importa dati dal menu File, un'applicazione potrebbe visualizzare un elenco di descrizioni per i driver che specificano un valore FileUsage di 0 o 2 e "Y" come secondo carattere del valore della parola chiave ConnectFunctions. Dopo che l'utente ha selezionato un driver, l'applicazione richiama SQLDriverConnect con la parola chiave DRIVER e quindi visualizza una finestra di dialogo personalizzata Seleziona tabella. |
| SQLLevel | Un numero che indica la grammatica SQL-92 supportata dal driver: 0 = SQL-92 Entry 1 = FIPS127-2 Transitional 2 = SQL-92 Intermediate 3 = SQL-92 Full Deve essere uguale al valore restituito per l'opzione SQL_SQL_CONFORMANCE in SQLGetInfo. |
Per informazioni sui conteggi di utilizzo, vedere Conteggio di utilizzo illustrata in una parte precedente di questa sezione.
Le applicazioni non dovrebbero impostare il conteggio di utilizzo. ODBC manterrà questo conteggio.
Ad esempio, supponiamo che un driver per i file di testo formattato abbia una DLL del driver denominata Text.dll, una DLL di impostazione del driver separata denominata Txtsetup.dll e che sia stato installato tre volte. Se il driver supporta il livello di conformità API di livello 1, supporta il livello di conformità grammaticale SQL minimo, tratta i file come tabelle e può utilizzare file con estensioni .txt e .csv, i valori sotto la sottochiave Testo potrebbero essere i seguenti:
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