SQLManageDataSources
Kesesuaian
Versi diperkenalkan: ODBC 2.0
Ringkasan
SQLManageDataSources menampilkan kotak dialog tempat pengguna dapat menyiapkan, menambahkan, dan menghapus sumber data dalam informasi sistem.
Sintaks
BOOL SQLManageDataSources(
HWND hwnd);
Argumen
hwnd
[Input] Handel jendela induk.
Kembali
SQLManageDataSources mengembalikan FALSE jika hwnd bukan handel jendela yang valid. Jika tidak, ia mengembalikan TRUE.
Diagnostik
Ketika SQLManageDataSources 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_REQUEST_FAILED | Permintaan gagal | Panggilan ke ConfigDSN gagal. |
ODBC_ERROR_INVALID__HWND | Handel jendela tidak valid | Argumen hwnd tidak valid atau NULL. |
ODBC_ERROR_OUT_OF_MEM | Kehabisan memori | Alat penginstal tidak dapat melakukan fungsi karena kurangnya memori. |
Mengelola Sumber Data
SQLManageDataSources awalnya menampilkan kotak dialog Administrator Sumber Data ODBC, seperti yang diperlihatkan dalam ilustrasi berikut.
Kotak dialog menampilkan sumber data yang tercantum dalam informasi sistem di bawah tiga tab: DSN Pengguna, DSN Sistem, dan File DSN. Jika pengguna mengklik dua kali sumber data atau memilih sumber data dan mengklik Konfigurasikan, SQLManageDataSources memanggil ConfigDSN di DLL penyiapan dengan opsi ODBC_CONFIG_DSN.
Jika pengguna mengklik Tambahkan, SQLManageDataSources menampilkan kotak dialog Buat Sumber Data Baru, diperlihatkan dalam ilustrasi berikut.
Kotak dialog menampilkan daftar driver yang terinstal. Jika pengguna mengklik ganda driver atau memilih driver dan mengklik OK, SQLManageDataSources memanggil ConfigDSN di DLL penyiapan dan meneruskannya opsi ODBC_ADD_DSN.
Jika pengguna memilih sumber data dan mengklik Hapus, SQLManageDataSources menanyakan apakah pengguna ingin menghapus sumber data. Jika pengguna mengklik Ya, SQLManageDataSources memanggil ConfigDSN di DLL penyiapan dengan opsi ODBC_REMOVE_DSN.
Kotak dialog Buat Sumber Data Baru digunakan untuk menambahkan atau menghapus sumber data pengguna, sumber data sistem, atau sumber data file.
DSN Pengguna
DSN yang dibuat untuk pengguna individual akan disebut DSN Pengguna, untuk membedakannya dari DSN Sistem. DSN pengguna terdaftar sebagai berikut dalam informasi sistem:
HKEY_CURRENT_USERS
SOFTWARE
ODBC
Odbc.ini
DSN Sistem
Kotak dialog Buat Sumber Data Baru memungkinkan Anda menambahkan sumber data sistem ke komputer lokal Anda atau menghapusnya, atau untuk mengatur konfigurasi untuk sumber data sistem.
Sumber data yang disiapkan dengan nama sumber data sistem (DSN) dapat digunakan oleh lebih dari satu pengguna pada komputer yang sama. Ini juga dapat digunakan oleh layanan di seluruh sistem, yang kemudian dapat memperoleh akses ke sumber data bahkan jika tidak ada pengguna yang masuk ke komputer.
DSN Sistem terdaftar dalam entri HKEY_LOCAL_MACHINE dalam informasi sistem daripada di entri HKEY_CURRENT_USER. Ini tidak terkait dengan satu pengguna yang masuk dengan nama pengguna dan kata sandi khususnya tetapi dapat digunakan oleh pengguna mana pun dari komputer tersebut atau oleh layanan systemwide otomatis. Sistem DSN, bagaimanapun, terkait dengan satu komputer. Ini tidak mendukung kemampuan menggunakan DSN jarak jauh antar mesin. DSN sistem terdaftar sebagai berikut dalam informasi sistem:
HKEY_LOCAL_MACHINE PERANGKAT LUNAK ODBC Odbc.ini
DSN File
Sumber data file tidak memiliki nama sumber data, seperti halnya sumber data komputer, dan tidak terdaftar untuk satu pengguna atau komputer mana pun. Informasi koneksi untuk sumber data tersebut terkandung dalam file .dsn yang dapat disalin ke komputer apa pun. Sumber data file dapat dibagikan, dalam hal ini file .dsn berada di jaringan dan dapat digunakan secara bersamaan oleh beberapa pengguna di jaringan selama pengguna menginstal driver yang sesuai. Sumber data file juga dapat tidak dapat dibuat, dalam hal ini hanya dapat digunakan pada satu komputer.
Untuk informasi selengkapnya tentang sumber data file, lihat Menyambungkan Menggunakan Sumber Data File, atau lihat SQLDriverConnect.
Mengelola Driver
Jika pengguna mengklik tab Driver dalam kotak dialog Administrator Sumber Data ODBC, SQLManageDataSources menampilkan daftar driver ODBC yang diinstal pada sistem, serta informasi tentang driver. Tanggal yang ditampilkan adalah tanggal pembuatan driver, seperti yang ditunjukkan dalam ilustrasi berikut.
Opsi Pelacakan
Jika pengguna mengklik tab Pelacakan dalam kotak dialog Administrator Sumber Data ODBC, SQLManageDataSources menampilkan opsi pelacakan, seperti yang diperlihatkan dalam ilustrasi berikut.
Jika pengguna mengklik Mulai Pelacakan Sekarang lalu mengklik OK, SQLManageDataSources memungkinkan pelacakan secara manual untuk semua aplikasi yang saat ini berjalan di komputer.
Jika pengguna menentukan nama file pelacakan di kotak teks Jalur file Log lalu mengklik OK, SQLManageDataSources mengatur kata kunci TraceFile di bagian [ODBC] dari informasi sistem ke nama yang ditentukan.
Penting
Dukungan untuk Visual Studio Analyzer dihapus dimulai di Windows 8 (Visual Studio Analyzer hanya disertakan dalam versi Visual Studio yang lebih lama.). Untuk mekanisme pemecahan masalah alternatif, gunakan pelacakan BID.
Jika pengguna mengklik Mulai Visual Studio Analyzer lalu mengklik OK, Visual Studio Analyzer diaktifkan. Ini tetap diaktifkan sampai Stop Visual Studio Analyzer diklik.
Untuk informasi selengkapnya tentang pelacakan, lihat Pelacakan. Untuk informasi selengkapnya tentang kata kunci Trace dan TraceFile , lihat Odbc Subkey.
Fungsi Terkait
Untuk informasi tentang | Lihat |
---|---|
Membuat sumber data | SQLCreateDataSource |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk