Fungsi SQLValidDSN

Kesesuaian
Versi diperkenalkan: ODBC 2.0

Ringkasan
SQLValidDSN memeriksa panjang dan validitas nama sumber data sebelum nama ditambahkan ke informasi sistem.

Sintaks

  
BOOL SQLValidDSN(  
     LPCSTR    lpszDSN);  

Argumen

lpszDSN
[Input] Nama sumber data yang akan diperiksa.

Kembali

Fungsi mengembalikan TRUE jika nama sumber data valid. Ini mengembalikan FALSE jika nama sumber data tidak valid atau panggilan fungsi gagal.

Diagnostik

Ketika SQLValidDSN mengembalikan FALSE, nilai *pfErrorCode terkait dapat diperoleh dengan memanggil SQLInstallerError. *pfErrorCode dikembalikan hanya jika panggilan fungsi gagal, bukan jika FALSE dikembalikan karena nama sumber data tidak valid. 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_OUT_OF_MEM	Kehabisan memori	Alat penginstal tidak dapat melakukan fungsi karena kurangnya memori.

Komentar

SQLValidDSN dipanggil oleh ConfigDSN driver untuk memeriksa panjang nama sumber data dan validitas karakter individual dalam nama sumber data. Ini memeriksa apakah panjang nama lebih besar dari SQL_MAX_DSN_LENGTH, seperti yang didefinisikan dalam Sqlext.h. (Panjang nama sumber data juga diperiksa oleh SQLWritedsnToIni.) SQLValidDSN memeriksa apakah salah satu karakter yang tidak valid berikut disertakan dalam nama sumber data:

[ ] { } ( ) , ; ? * = ! @ \

Fungsi Terkait

Untuk informasi tentang	Lihat
Menambahkan, memodifikasi, atau menghapus sumber data	ConfigDSN (di DLL Penyiapan)
Menambahkan, memodifikasi, atau menghapus sumber data	SQLConfigDataSource
Menulis nama sumber data ke informasi sistem	SQLWritedsnToIni