Bagikan melalui

Fungsi SQLWriteDSNToIni

  • Artikel

Kesesuaian
Versi Diperkenalkan: ODBC 1.0

Ringkasan
SQLWriteDSNToIni menambahkan sumber data ke informasi sistem.

Sintaks

  
BOOL SQLWriteDSNToIni(  
     LPCSTR   lpszDSN,  
     LPCSTR   lpszDriver);

Argumen

lpszDSN
[Input] Nama sumber data yang akan ditambahkan.

lpszDriver
[Input] Deskripsi driver (biasanya nama DBMS terkait) yang disajikan kepada pengguna alih-alih nama driver fisik.

Kembali

Fungsi mengembalikan TRUE jika berhasil, FALSE jika gagal.

Diagnostik

Ketika SQLWriteDSNToIni 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_DSN DSN Tidak Valid Argumen lpszDSN berisi string yang tidak valid untuk DSN.
ODBC_ERROR_INVALID_NAME Nama pengandar atau penerjemah tidak valid Argumen lpszDriver tidak valid.
ODBC_ERROR_REQUEST_FAILED Permintaan gagal Alat penginstal gagal membuat DSN di registri.
ODBC_ERROR_OUT_OF_MEM Kehabisan memori Alat penginstal tidak dapat melakukan fungsi karena kurangnya memori.

Komentar

SQLWriteDSNToIni menambahkan sumber data ke bagian [Sumber Data ODBC] dari informasi sistem. Kemudian membuat bagian spesifikasi untuk sumber data dan menambahkan satu kata kunci (Driver) dengan nama DLL driver sebagai nilainya. Jika bagian spesifikasi sumber data sudah ada, SQLWriteDSNToIni menghapus bagian lama sebelum membuat yang baru.

Pemanggil fungsi ini harus menambahkan kata kunci dan nilai khusus driver ke bagian spesifikasi sumber data dari informasi sistem.

Jika nama sumber data adalah Default, SQLWriteDSNToIni juga membuat bagian spesifikasi driver default dalam informasi sistem.

Fungsi ini harus dipanggil hanya dari DLL penyiapan.

Untuk informasi tentang Lihat
Menambahkan, memodifikasi, atau menghapus sumber data ConfigDSN(di DLL Penyiapan)
Menambahkan, memodifikasi, atau menghapus sumber data SQLConfigDataSource
Menghapus nama sumber data dari informasi sistem SQLRemovedsnFromIni