Fungsi WritePrivateProfileSectionA (winbase.h)
Menggantikan kunci dan nilai untuk bagian yang ditentukan dalam file inisialisasi.
Sintaks
BOOL WritePrivateProfileSectionA(
[in] LPCSTR lpAppName,
[in] LPCSTR lpString,
[in] LPCSTR lpFileName
);
Parameter
[in] lpAppName
Nama bagian tempat data ditulis. Nama bagian ini biasanya merupakan nama aplikasi panggilan.
[in] lpString
Nama kunci baru dan nilai terkait yang akan ditulis ke bagian bernama. String ini dibatasi hingga 65.535 byte.
[in] lpFileName
Nama file inisialisasi. Jika parameter ini tidak berisi jalur lengkap untuk file, fungsi akan mencari direktori Windows untuk file tersebut. Jika file tidak ada dan lpFileName tidak berisi jalur lengkap, fungsi membuat file di direktori Windows.
Jika file ada dan dibuat menggunakan karakter Unicode, fungsi menulis karakter Unicode ke file. Jika tidak, fungsi membuat file menggunakan karakter ANSI.
Nilai kembali
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Data dalam buffer yang ditunjukkan oleh parameter lpString terdiri dari satu atau beberapa string yang dihentikan null, diikuti oleh karakter null akhir. Setiap string memiliki formulir berikut:
Kunci=String
Fungsi WritePrivateProfileSection tidak peka huruf besar/kecil; string yang ditunjukkan oleh parameter lpAppName dapat berupa kombinasi huruf besar dan huruf kecil.
Jika tidak ada nama bagian yang cocok dengan string yang diarahkan oleh parameter lpAppName , WritePrivateProfileSection membuat bagian di akhir file inisialisasi yang ditentukan dan menginisialisasi bagian baru dengan nama kunci dan pasangan nilai yang ditentukan.
WritePrivateProfileSection menghapus kunci dan nilai yang ada untuk bagian bernama dan menyisipkan nama kunci dan nilai dalam buffer yang diarahkan oleh parameter lpString . Fungsi ini tidak mencoba menghubungkan nama kunci lama dan baru; jika nama baru muncul dalam urutan yang berbeda dari nama lama, komentar apa pun yang terkait dengan kunci dan nilai yang sudah ada sebelumnya dalam file inisialisasi mungkin akan dikaitkan dengan kunci dan nilai yang salah.
Operasi ini bersifat atom; tidak ada operasi yang membaca dari atau menulis ke file inisialisasi yang ditentukan yang diizinkan saat informasi sedang ditulis.
Sistem menyimpan versi cache dari pemetaan file registri terbaru untuk meningkatkan performa. Jika semua parameter NULL, fungsi akan menghapus cache. Saat sistem mengedit versi file yang di-cache, proses yang mengedit file itu sendiri akan menggunakan file asli sampai cache telah dibersihkan.
Sistem memetakan sebagian besar .ini referensi file ke registri, menggunakan pemetaan yang ditentukan di bawah kunci registri berikut:
HKEY_LOCAL_MACHINE SOFTWARE Microsoft Windows NT CurrentVersion IniFileMapping
Pemetaan ini kemungkinan jika aplikasi memodifikasi file inisialisasi komponen sistem, seperti Control.ini, System.ini, dan Winfile.ini. Dalam hal ini, fungsi menulis informasi ke registri, bukan ke file inisialisasi; perubahan lokasi penyimpanan tidak berpengaruh pada perilaku fungsi.
Fungsi profil menggunakan langkah-langkah berikut untuk menemukan informasi inisialisasi:
- Lihat di registri untuk nama file inisialisasi di bawah kunci IniFileMapping .
- Cari nama bagian yang ditentukan oleh lpAppName. Ini akan menjadi nilai bernama di bawah kunci yang memiliki nama file inisialisasi, atau subkunjud dengan nama ini, atau nama tidak akan ada sebagai nilai atau subkunjud.
- Jika nama bagian yang ditentukan oleh lpAppName adalah nilai bernama, maka nilai tersebut menentukan di mana dalam registri Anda akan menemukan kunci untuk bagian tersebut.
- Jika nama bagian yang ditentukan oleh lpAppName adalah subkunci, maka nilai bernama di bawah subkunci tersebut menentukan di mana dalam registri Anda akan menemukan kunci untuk bagian tersebut. Jika kunci yang Anda cari tidak ada sebagai nilai bernama, maka akan ada nilai yang tidak disebutkan namanya (ditampilkan sebagai <Tidak Ada Nama>) yang menentukan lokasi default di registri tempat Anda akan menemukan kunci.
- Jika nama bagian yang ditentukan oleh lpAppName tidak ada sebagai nilai bernama atau sebagai subkunjud, maka akan ada nilai yang tidak disebutkan namanya (ditampilkan sebagai <Tidak Ada Nama>) yang menentukan lokasi default di registri tempat Anda akan menemukan kunci untuk bagian tersebut.
- Jika tidak ada subkuntang atau entri untuk nama bagian, cari file inisialisasi aktual pada disk dan baca kontennya.
- ! - karakter ini memaksa semua penulisan untuk masuk ke registri dan ke file .ini pada disk.
- # - karakter ini menyebabkan nilai registri diatur ke nilai dalam file .ini Windows 3.1 saat pengguna baru masuk untuk pertama kalinya setelah penyiapan.
- @ - karakter ini mencegah pembacaan masuk ke file .ini pada disk jika data yang diminta tidak ditemukan di registri.
- USR: - awalan ini adalah singkatan dari HKEY_CURRENT_USER, dan teks setelah awalan relatif terhadap kunci tersebut.
- SYS: - awalan ini adalah singkatan dariHKEY_LOCAL_MACHINE\SOFTWARE, dan teks setelah awalan relatif terhadap kunci tersebut.
Catatan
Header winbase.h mendefinisikan WritePrivateProfileSection sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | winbase.h (termasuk Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |