Fungsi SQLRemoveTranslator

Kesesuaian
Versi diperkenalkan: ODBC 3.0

Ringkasan
SQLRemoveTranslator menghapus informasi tentang penerjemah dari bagian Odbcinst.ini dari informasi sistem dan menyatakan jumlah penggunaan komponen penerjemah sebesar 1.

Sintaks

  
BOOL SQLRemoveTranslator(  
     LPCSTR    lpszTranslator,  
     LPDWORD   lpdwUsageCount);  

Argumen

lpszTranslator
[Input] Nama penerjemah sebagaimana terdaftar dalam kunci Odbcinst.ini dari informasi sistem.

lpdwUsageCount
[Output] Jumlah penggunaan penerjemah setelah fungsi ini dipanggil.

Kembali

Fungsi mengembalikan TRUE jika berhasil, FALSE jika gagal. Jika tidak ada entri dalam informasi sistem ketika fungsi ini dipanggil, fungsi mengembalikan FALSE.

Diagnostik

Ketika SQLRemoveTranslator 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_GENERAL_ERR	Kesalahan penginstal umum	Terjadi kesalahan karena tidak ada kesalahan penginstal tertentu.
ODBC_ERROR_COMPONENT_NOT_FOUND	Komponen tidak ditemukan dalam registri	Alat penginstal tidak dapat menghapus informasi penerjemah karena tidak ada di registri atau tidak dapat ditemukan di registri.
ODBC_ERROR_INVALID_NAME	Nama pengandar atau penerjemah tidak valid	Argumen lpszTranslator tidak valid.
ODBC_ERROR_USAGE_UPDATE_FAILED	Tidak dapat menaikkan atau mengurangi jumlah penggunaan komponen	Alat penginstal gagal mengurangi jumlah penggunaan driver.
ODBC_ERROR_OUT_OF_MEM	Kehabisan memori	Alat penginstal tidak dapat melakukan fungsi karena kurangnya memori.

Komentar

SQLRemoveTranslator melengkapi fungsi SQLInstallTranslatorEx dan memperbarui jumlah penggunaan komponen dalam informasi sistem. Fungsi ini harus dipanggil hanya dari aplikasi penyiapan.

SQLRemoveTranslator akan mendekremen jumlah penggunaan komponen sebesar 1. Jika jumlah penggunaan komponen masuk ke 0, entri penerjemah dalam informasi sistem akan dihapus. Entri penerjemah berada di lokasi berikut dalam informasi sistem, di bawah nama penerjemah:

HKEY_LOCAL_MACHINE

SOFTWARE

ODBC

Odbcinst.ini

SQLRemoveTranslator tidak benar-benar menghapus file apa pun. Program panggilan bertanggung jawab untuk menghapus file, dan mempertahankan jumlah penggunaan file. Hanya setelah jumlah penggunaan komponen dan jumlah penggunaan file mencapai nol adalah file yang dihapus secara fisik. Beberapa file dalam komponen dapat dihapus, dan yang lain tidak dihapus, tergantung pada apakah file digunakan oleh aplikasi lain yang telah meningkatkan jumlah penggunaan file.

SQLRemoveTranslator juga disebut sebagai bagian dari proses peningkatan. Jika aplikasi mendeteksi bahwa aplikasi harus melakukan peningkatan dan sebelumnya telah menginstal driver, driver harus dihapus dan kemudian diinstal ulang. SQLRemoveTranslator harus terlebih dahulu dipanggil untuk mendekremen jumlah penggunaan komponen, lalu SQLInstallTranslatorEx harus dipanggil untuk menaikkan jumlah penggunaan komponen. Program penyiapan aplikasi harus mengganti file lama secara fisik dengan file baru. Jumlah penggunaan file akan tetap sama, dan aplikasi lain yang menggunakan file versi yang lebih lama sekarang akan menggunakan versi yang lebih baru.

Fungsi Terkait

Untuk informasi tentang	Lihat
Menginstal penerjemah	SQLInstallTranslatorEx