Fungsi SQLWritePrivateProfileString

Kesesuaian
Versi diperkenalkan: ODBC 2.0

Ringkasan
SQLWritePrivateProfileString menulis nama nilai dan data ke subkuncu Odbc.ini informasi sistem.

Sintaks

  
BOOL SQLWritePrivateProfileString(  
     LPCSTR     lpszSection,  
     LPCSTR     lpszEntry,  
     LPCSTR     lpszString,  
     LPCSTR     lpszFilename);  

Argumen

lpszSection
[Input] Menunjuk ke string null-terminated yang berisi nama bagian tempat string akan disalin. Jika bagian tidak ada, bagian tersebut dibuat. Nama bagian tidak bergantung pada huruf besar/kecil; string dapat berupa kombinasi huruf besar dan huruf kecil.

lpszEntry
[Input] Menunjuk ke string null-terminated yang berisi nama kunci yang akan dikaitkan dengan string. Jika kunci tidak ada di bagian yang ditentukan, kunci tersebut akan dibuat. Jika argumen ini NULL, seluruh bagian, termasuk semua entri dalam bagian , dihapus.

lpszString
[Input] Menunjuk ke string yang dihentikan null untuk ditulis ke file. Jika argumen ini NULL, kunci yang ditujukkan oleh argumen lpszEntry dihapus.

lpszFilename
[Output] Menunjuk ke string null-terminated yang menamai file inisialisasi.

Mengembalikan

Fungsi mengembalikan TRUE jika berhasil, FALSE jika gagal.

Diagnostik

Ketika SQLWritePrivateProfileString 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	Informasi sistem yang diminta tidak dapat ditulis.
ODBC_ERROR_OUT_OF_MEM	Kehabisan memori	Alat penginstal tidak dapat melakukan fungsi karena kurangnya memori.

Komentar

SQLWritePrivateProfileString disediakan sebagai cara sederhana untuk port driver dan DRIVER setup DLL dari Microsoft Windows ke Microsoft Windows NT/Windows 2000. Panggilan ke WritePrivateProfileString yang menulis string profil ke file Odbc.ini harus diganti dengan panggilan ke SQLWritePrivateProfileString. SQLWritePrivateProfileString memanggil fungsi di API Win32 untuk menambahkan nama nilai dan data yang ditentukan ke subkuntah Odbc.ini informasi sistem.

Mode konfigurasi menunjukkan tempat entri Odbc.ini mencantumkan nilai DSN dalam informasi sistem. Jika DSN adalah DSN Pengguna (variabel status USERDSN_ONLY), fungsi menulis ke entri Odbc.ini di HKEY_CURRENT_USER. Jika DSN adalah DSN Sistem (SYSTEMDSN_ONLY), fungsi menulis ke entri Odbc.ini di HKEY_LOCAL_MACHINE. Jika variabel status adalah BOTHDSN, HKEY_CURRENT_USER dicoba, dan jika gagal, HKEY_LOCAL_MACHINE digunakan.

Fungsi Terkait

Untuk informasi tentang	Lihat
Mendapatkan nilai dari informasi sistem	SQLGetPrivateProfileString