Fungsi ConfigTranslator

Kesesuaian
Versi diperkenalkan: ODBC 2.0

Ringkasan
ConfigTranslator mengembalikan opsi terjemahan default untuk penerjemah. Ini dapat berada di DLL penerjemah atau DLL penyiapan terpisah.

Sintaks

  
BOOL ConfigTranslator(  
     HWND     hwndParent,  
     DWORD *  pvOption);  

Argumen

hwndParent
[Input] Handel jendela induk. Fungsi tidak akan menampilkan kotak dialog apa pun jika handel null.

pvOption
[Output] Opsi terjemahan 32-bit.

Kembali

Fungsi mengembalikan TRUE jika berhasil, FALSE jika gagal.

Diagnostik

Ketika ConfigTranslator mengembalikan FALSE, nilai *pfErrorCode terkait diposting ke buffer kesalahan penginstal dengan panggilan ke SQLPostInstallerError dan 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_HWND	Handel jendela tidak valid	Argumen hwndParent tidak valid atau NULL.
ODBC_ERROR_DRIVER_SPECIFIC	Kesalahan khusus driver atau penerjemah	Kesalahan khusus driver yang tidak ada kesalahan penginstal ODBC yang ditentukan. Argumen SzError dalam panggilan ke fungsi SQLPostInstallerError harus berisi pesan kesalahan khusus driver.
ODBC_ERROR_INVALID_OPTION	Opsi terjemahan tidak valid	Argumen pvOption berisi nilai yang tidak valid.

Komentar

Jika penerjemah hanya mendukung satu opsi terjemahan, ConfigTranslator mengembalikan TRUE dan mengatur pvOption ke opsi 32-bit. Jika tidak, ini menentukan opsi terjemahan default untuk digunakan. ConfigTranslator dapat menampilkan kotak dialog tempat pengguna memilih opsi terjemahan default.

Fungsi Terkait

Untuk informasi tentang	Lihat
Mendapatkan opsi terjemahan	SQLGetConnectAttr
Memilih penerjemah	SQLGetTranslator
Mengatur opsi terjemahan	SQLSetConnectAttr