Subkunci Spesifikasi Driver
Setiap driver yang tercantum dalam subkunjung Driver ODBC memiliki subkunjung sendiri. Subkunjung ini memiliki nama yang sama dengan nilai yang sesuai di bawah subkunjung Driver ODBC. Nilai di bawah subkuntang ini mencantumkan jalur lengkap DLL penyiapan driver dan driver, nilai kata kunci driver yang dikembalikan oleh SQLDrivers, dan jumlah penggunaan. Format nilai seperti yang diperlihatkan dalam tabel berikut ini.
| Nama | Jenis data | Data |
|---|---|---|
| APILevel | REG_SZ | 0 | 1 2 | |
| ConnectFunctions | REG_SZ | {Y|N}{Y|N}{Y|N} |
| CreateDSN | REG_SZ | deskripsi driver |
| Driver | REG_SZ | driver-DLL-path |
| DriverODBCVer | REG_SZ | nn.nn |
| FileExtns | REG_SZ | *. file-extension1[,*. ekstensi file2]... |
| FileUsage | REG_SZ | 0 | 1 2 | |
| Siapkan | REG_SZ | setup-DLL-path |
| SQLLevel | REG_SZ | 0 | 1 2 | |
| UsageCount | REG_DWORD | count |
Penggunaan setiap kata kunci diperlihatkan dalam tabel berikut.
| Kata kunci | Penggunaan |
|---|---|
| APILevel | Angka yang menunjukkan tingkat kesuaian antarmuka ODBC yang didukung oleh driver: 0 = Tidak ada 1 = Level 1 didukung 2 = Level 2 didukung Ini harus sama dengan nilai yang dikembalikan untuk opsi SQL_ODBC_INTERFACE_CONFORMANCE di SQLGetInfo. |
| CreateDSN | Nama satu atau beberapa sumber data yang akan dibuat saat driver diinstal. Informasi sistem harus menyertakan satu bagian spesifikasi sumber data untuk setiap sumber data yang tercantum dengan kata kunci CreateDSN . Bagian ini tidak boleh menyertakan kata kunci Driver , karena ini ditentukan di bagian spesifikasi driver, tetapi harus menyertakan informasi yang cukup untuk fungsi ConfigDSN dalam DLL penyiapan driver untuk membuat spesifikasi sumber data tanpa menampilkan kotak dialog apa pun. Untuk bagian format spesifikasi sumber data, lihat Subkunjuk Spesifikasi Sumber Data. |
| ConnectFunctions | String tiga karakter yang menunjukkan apakah driver mendukung SQLConnect, SQLDriverConnect, dan SQLBrowseConnect. Jika driver mendukung SQLConnect, karakter pertama adalah "Y"; jika tidak, itu adalah "N". Jika driver mendukung SQLDriverConnect, karakter kedua adalah "Y"; jika tidak, itu adalah "N". Jika driver mendukung SQLBrowseConnect, karakter ketiga adalah "Y"; jika tidak, itu adalah "N". Misalnya, jika driver mendukung SQLConnect dan SQLDriverConnect tetapi bukan SQLBrowseConnect, string tiga karakter adalah "YYN". |
| DriverODBCVer | String karakter dengan versi ODBC yang didukung driver. Versinya adalah formulir nn.nn, di mana dua digit pertama adalah versi utama dan dua digit berikutnya adalah versi minor. Untuk versi ODBC yang dijelaskan dalam manual ini, driver harus mengembalikan "03.00". Ini harus sama dengan nilai yang dikembalikan untuk opsi SQL_DRIVER_ODBC_VER di SQLGetInfo. |
| FileExtns | Untuk driver berbasis file, daftar ekstensi file yang dipisahkan koma yang dapat digunakan driver. Misalnya, driver dBASE mungkin menentukan *.dbf dan driver file teks berformat mungkin menentukan *.txt,*.csv. Untuk contoh bagaimana aplikasi mungkin menggunakan informasi ini, lihat kata kunci FileUsage . |
| FileUsage | Angka yang menunjukkan bagaimana driver berbasis file secara langsung memperlakukan file di sumber data. 0 = Driver bukan driver berbasis file. Misalnya, driver ORACLE adalah driver berbasis DBMS. 1 = Driver berbasis file memperlakukan file dalam sumber data sebagai tabel. Misalnya, driver Xbase memperlakukan setiap file Xbase sebagai tabel. 2 = Driver berbasis file memperlakukan file dalam sumber data sebagai katalog. Misalnya, driver Microsoft Access memperlakukan setiap file Microsoft Access sebagai database lengkap. Aplikasi mungkin menggunakan ini untuk menentukan bagaimana pengguna akan memilih data. Misalnya, pengguna Xbase dan Paradox sering menganggap data seperti yang disimpan dalam file, sementara pengguna ORACLE dan Microsoft Access umumnya menganggap data sebagai disimpan dalam tabel. Saat pengguna memilih Buka File Data dari menu File , aplikasi dapat menampilkan kotak dialog umum Buka File Windows. Daftar jenis file akan menggunakan ekstensi file yang ditentukan dengan kata kunci FileExtns untuk driver yang menentukan nilai FileUsage 1 dan "Y" sebagai karakter kedua dari nilai kata kunci ConnectFunctions . Setelah pengguna memilih file, aplikasi akan memanggil SQLDriverConnect dengan kata kunci DRIVER lalu menjalankan pernyataan SELECT * FROM table-name. Ketika pengguna memilih Impor Data dari menu File , aplikasi dapat menampilkan daftar deskripsi untuk driver yang menentukan nilai FileUsage 0 atau 2, dan "Y" sebagai karakter kedua dari nilai kata kunci ConnectFunctions . Setelah pengguna memilih driver, aplikasi akan memanggil SQLDriverConnect dengan kata kunci DRIVER lalu menampilkan kotak dialog Pilih Tabel kustom. |
| SQLLevel | Angka yang menunjukkan tata bahasa SQL-92 yang didukung oleh driver: 0 = Entri SQL-92 1 = FIPS127-2 Transisi 2 = SQL-92 Menengah 3 = SQL-92 Penuh Ini harus sama dengan nilai yang dikembalikan untuk opsi SQL_SQL_CONFORMANCE di SQLGetInfo. |
Untuk informasi tentang jumlah penggunaan, lihat Penghitungan Penggunaan sebelumnya di bagian ini.
Aplikasi tidak boleh mengatur jumlah penggunaan. ODBC akan mempertahankan jumlah ini.
Misalnya, driver untuk file teks yang diformat memiliki DLL driver bernama Text.dll, DLL penyiapan driver terpisah bernama Txtsetup.dll, dan telah diinstal tiga kali. Jika driver mendukung tingkat kesuaian API Level 1, mendukung tingkat kesuaian tata bahasa Minimum SQL, memperlakukan file sebagai tabel, dan dapat menggunakan file dengan ekstensi .txt dan .csv, nilai di bawah subkunjuk Teks mungkin sebagai berikut:
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