Fungsi SQLInstallDriverManager

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

Ringkasan
SQLInstallDriverManager mengembalikan jalur direktori target untuk penginstalan komponen inti ODBC. Program panggilan harus benar-benar menyalin file Manajer Driver ke direktori target.

Sintaks

  
BOOL SQLInstallDriverManager(  
     LPSTR    lpszPath,  
     WORD     cbPathMax,  
     WORD *   pcbPathOut);  

Argumen

lpszPath
[Output] Jalur direktori target penginstalan.

cbPathMax
[Input] Panjang lpszPath. Ini harus setidaknya _MAX_PATH byte.

pcbPathOut
[Output] Jumlah total byte (tidak termasuk byte penghentian null) yang dikembalikan dalam lpszPath. Jika jumlah byte yang tersedia untuk dikembalikan lebih besar dari atau sama dengan cbPathMax, jalur di lpszPath dipotong menjadi cbPathMax dikurangi karakter null-termination. Argumen pcbPathOut dapat berupa penunjuk null.

Kembali

Fungsi mengembalikan TRUE jika berhasil, FALSE jika gagal.

Diagnostik

Saat SQLInstallDriverManager 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_INVALID_BUFF_LEN	Panjang buffer tidak valid	Argumen lpszPath tidak cukup besar untuk berisi jalur output. Buffer berisi jalur terpotong. Argumen cbPathMax kurang dari _MAX_PATH.
ODBC_ERROR_USAGE_UPDATE_FAILED	Tidak dapat menaikkan atau mengurangi jumlah penggunaan komponen	Alat penginstal gagal menaikkan jumlah penggunaan komponen inti ODBC.
ODBC_ERROR_OUT_OF_MEM	Kehabisan memori	Alat penginstal tidak dapat melakukan fungsi karena kurangnya memori.

Komentar

SQLInstallDriverManager dipanggil untuk mengembalikan jalur untuk komponen inti ODBC dan menaikkan jumlah penggunaan komponen dalam informasi sistem. Jika versi Manajer Driver sudah ada tetapi jumlah penggunaan komponen untuk driver tidak ada, nilai jumlah penggunaan komponen baru diatur ke 2.

Program penyiapan aplikasi bertanggung jawab untuk menyalin file komponen inti secara fisik dan mempertahankan jumlah penggunaan file. Jika file komponen inti sebelumnya belum diinstal, program penyiapan aplikasi harus menyalin file, dan membuat jumlah penggunaan file. Jika file sebelumnya telah diinstal, program penyiapan hanya menaikkan jumlah penggunaan file.

Jika versi lama Driver Manager sebelumnya diinstal oleh program penyiapan aplikasi, komponen inti harus dihapus instalasinya lalu diinstal ulang, sehingga jumlah penggunaan komponen inti valid. SQLRemoveDriverManager harus terlebih dahulu dipanggil untuk mengurangi jumlah penggunaan komponen. SQLInstallDriverManager 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.

Dalam instalasi baru komponen inti ODBC, driver, dan penerjemah, program penyiapan aplikasi harus memanggil fungsi berikut secara berurutan: SQLInstallDriverManager, SQLInstallDriverEx, SQLConfigDriver (dengan fRequest ODBC_INSTALL_DRIVER), lalu SQLInstallTranslatorEx. Dalam penghapusan instalasi komponen inti, driver, dan penerjemah, program penyiapan aplikasi harus memanggil fungsi berikut secara berurutan: SQLRemoveTranslator, SQLRemoveDriver, lalu SQLRemoveDriverManager. Fungsi-fungsi ini harus dipanggil dalam urutan ini. Dalam peningkatan semua komponen, semua fungsi penghapusan instalasi harus dipanggil secara berurutan dan kemudian semua fungsi penginstalan harus dipanggil secara berurutan.

Fungsi Terkait

Untuk informasi tentang	Lihat
Menambahkan, memodifikasi, atau menghapus driver	SQLConfigDriver
Menginstal driver	SQLInstallDriverEx
Menginstal penerjemah	SQLInstallTranslatorEx
Menghapus driver	SQLRemoveDriver
Menghapus Driver Manager	SQLRemoveDriverManager
Menghapus penerjemah	SQLRemoveTranslator