Fungsi SQLGetConfigMode

Kesesuaian
Versi diperkenalkan: ODBC 3.0

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

Sintaks

  
BOOL SQLGetConfigMode(  
     UWORD *   pwConfigMode);  

Argumen

pwConfigMode
[Output] Penunjuk ke buffer yang berisi mode konfigurasi. (Lihat "Komentar.") Nilai dalam *pwConfigMode dapat berupa:

ODBC_USER_DSN

ODBC_SYSTEM_DSN

ODBC_BOTH_DSN

Kembali

Fungsi mengembalikan TRUE jika berhasil, FALSE jika gagal.

Diagnostik

Ketika SQLGetConfigMode 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_OUT_OF_MEM	Kehabisan memori	Alat penginstal tidak dapat melakukan fungsi karena kurangnya memori.

Komentar

Fungsi ini digunakan untuk menentukan di mana entri Odbc.ini yang mencantumkan nilai DSN berada dalam informasi sistem. Jika *pwConfigMode 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, HKEY_LOCAL_MACHINE digunakan.

Secara default, SQLGetConfigMode mengembalikan ODBC_BOTH_DSN. Saat DSN Pengguna atau DSN Sistem dibuat oleh panggilan ke SQLConfigDataSource, fungsi mengatur mode konfigurasi ke ODBC_USER_DSN atau ODBC_SYSTEM_DSN untuk membedakan pengguna dan DSN Sistem saat memodifikasi DSN. Sebelum kembali, SQLConfigDataSource mengatur ulang mode konfigurasi ke ODBC_BOTH_DSN.

Fungsi Terkait

Untuk informasi tentang	Lihat
Mengatur mode konfigurasi	SQLSetConfigMode