Fungsi SQLSetConfigMode

Kesesuaian
Versi diperkenalkan: ODBC 3.0

Ringkasan
SQLSetConfigMode mengatur mode konfigurasi yang menunjukkan di mana entri Odbc.ini yang mencantumkan nilai DSN berada dalam informasi sistem.

Sintaks

  
BOOL SQLSetConfigMode(  
     UWORD     wConfigMode);  

Argumen

wConfigMode
[Input] Mode konfigurasi penginstal (lihat "Komentar"). Nilai dalam wConfigMode dapat berupa:

ODBC_USER_DSN

ODBC_SYSTEM_DSN

ODBC_BOTH_DSN

Kembali

Fungsi mengembalikan TRUE jika berhasil, FALSE jika gagal.

Diagnostik

Ketika SQLSetConfigMode mengembalikan FALSE, nilai *pfErrorCode terkait dapat diperoleh dengan memanggil SQLInstallerError. Tabel berikut mencantumkan nilai *pfErrorCode yang dapat dikembalikan oleh SQLInstallerError dan menjelaskan masing-masing nilai dalam konteks fungsi ini.

*pfErrorCode	Kesalahan	Deskripsi
ODBC_ERROR_INVALID_PARAM_SEQUENCE	Urutan parameter tidak valid	Argumen wConfigMode tidak berisi ODBC_USER_DSN, ODBC_SYSTEM_DSN, atau ODBC_BOTH_DSN.

Komentar

Fungsi ini digunakan untuk mengatur tempat entri Odbc.ini yang mencantumkan nilai DSN berada dalam informasi sistem. Jika wConfigMode ODBC_USER_DSN, DSN adalah DSN Pengguna dan fungsi membaca dari entri Odbc.ini di HKEY_CURRENT_USER. Jika ODBC_SYSTEM_DSN, DSN adalah DSN Sistem dan fungsi membaca dari entri Odbc.ini di HKEY_LOCAL_MACHINE. Jika ODBC_BOTH_DSN, HKEY_CURRENT_USER dicoba, dan jika gagal, maka HKEY_LOCAL_MACHINE digunakan.

Fungsi ini tidak memengaruhi SQLCreateDataSource dan SQLDriverConnect. Mode konfigurasi harus diatur ketika driver membaca dari registri dengan memanggil SQLGetPrivateProfileString atau menulis ke registri dengan memanggil SQLWritePrivateProfileString. Panggilan ke SQLGetPrivateProfileString dan SQLWritePrivateProfileString menggunakan mode konfigurasi untuk mengetahui bagian registri mana yang akan dioperasikan.

Perhatian

SQLSetConfigMode harus dipanggil hanya jika perlu; jika mode diatur dengan tidak benar, Penginstal ODBC mungkin gagal berfungsi dengan baik.

SQLSetConfigMode membuat modifikasi registri langsung dari mode konfigurasi. Ini terlepas dari proses memodifikasi mode konfigurasi dengan panggilan ke SQLConfigDataSource. Panggilan ke SQLConfigDataSource mengatur mode konfigurasi untuk membedakan pengguna dan DSN Sistem saat memodifikasi DSN. Sebelum kembali, SQLConfigDataSource mengatur ulang mode konfigurasi ke BOTHDSN.

Fungsi Terkait

Untuk informasi tentang	Lihat
Membuat sumber data	SQLCreateDataSource
Menyambungkan ke sumber data menggunakan string koneksi atau kotak dialog	SQLDriverConnect
Mengambil mode konfigurasi	SQLGetConfigMode