Fungsi SQLRemoveDriverManager

Kesesuaian
Versi Diperkenalkan: ODBC 3.0: Tidak digunakan lagi di Windows XP Service Pack 2, Windows Server 2003 Service Pack 1, dan sistem operasi yang lebih baru.

Ringkasan
SQLRemoveDriverManager mengubah atau menghapus informasi tentang komponen inti ODBC dari entri Odbcinst.ini dalam informasi sistem.

Sintaks

  
BOOL SQLRemoveDriverManager(  
     LPDWORD     pdwUsageCount);  

Argumen

pdwUsageCount
[Output] Jumlah penggunaan Driver Manager 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

Saat SQLRemoveDriverManager 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 Manajer Driver karena tidak ada di registri atau tidak dapat ditemukan di registri.
ODBC_ERROR_USAGE_UPDATE_FAILED	Tidak dapat menaikkan atau mengurangi jumlah penggunaan komponen	Alat penginstal gagal mengurangi jumlah penggunaan Manajer Driver.
ODBC_ERROR_OUT_OF_MEM	Kehabisan memori	Alat penginstal tidak dapat melakukan fungsi karena kurangnya memori.

Komentar

SQLRemoveDriverManager melengkapi fungsi SQLInstallDriverManager , dan memperbarui jumlah penggunaan komponen dalam informasi sistem. Fungsi ini harus dipanggil hanya dari aplikasi penyiapan.

SQLRemoveDriverManager akan mengurangi jumlah penggunaan komponen inti sebesar 1. Jika jumlah penggunaan komponen masuk ke 0, informasi sistem entri akan dihapus. Entri komponen inti berada di lokasi berikut dalam informasi sistem, dengan judul "ODBC Core":

HKEY_LOCAL_MACHINE

SOFTWARE

ODBC

Odbcinst.ini

Perhatian

Aplikasi tidak boleh menghapus file Manajer Driver secara fisik ketika jumlah penggunaan komponen dan jumlah penggunaan file mencapai nol.

SQLRemoveDriverManager tidak benar-benar menghapus file apa pun. Program panggilan bertanggung jawab untuk menghapus file dan mempertahankan jumlah penggunaan file. Namun, file Manajer Driver tidak boleh dihapus ketika jumlah penggunaan komponen dan jumlah penggunaan file telah mencapai nol, karena file-file ini dapat digunakan oleh aplikasi lain yang belum menaikkan jumlah penggunaan file.

SQLRemoveDriverManager disebut sebagai bagian dari proses Hapus instalan. Komponen inti ODBC (yang mencakup Driver Manager, Cursor Library, Installer, Language Library, Administrator, thunking files, dan sebagainya) dihapus secara keseluruhan. File berikut ini tidak dihapus ketika SQLRemoveDriverManager dipanggil sebagai bagian dari proses Hapus instalasi:

ODBC32DLL
ODBCCR32.DLL
ODBCCU32.DLL
ODBCINT.DLL
ODBCTRAC.DLL
MSVCRT40.DLL
ODBCCP32.CPL

ODBCCP32.DLL
ODBC16GT.DLL
ODBC32GT.DLL
DS16GT.DLL
DS32GT.DLL
ODBCAD32.EXE

SQLRemoveDriverManager 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.

SQLRemoveDriverManager harus terlebih dahulu dipanggil untuk mengurangi jumlah penggunaan komponen. SQLInstallDriverEx kemudian harus dipanggil untuk menaikkan jumlah penggunaan komponen. Program penyiapan aplikasi harus mengganti file komponen inti lama dengan file baru. Jumlah penggunaan file akan tetap sama, dan aplikasi lain yang menggunakan file komponen inti versi lama sekarang akan menggunakan file versi yang lebih baru.

Fungsi Terkait

Untuk informasi tentang	Lihat
Menginstal Manajer Driver	SQLInstallDriverManager