Fungsi GetPrivateProfileSectionNames (winbase.h)
Mengambil nama semua bagian dalam file inisialisasi.
Sintaks
DWORD GetPrivateProfileSectionNames(
[out] LPTSTR lpszReturnBuffer,
[in] DWORD nSize,
[in] LPCTSTR lpFileName
);
Parameter
[out] lpszReturnBuffer
Penunjuk ke buffer yang menerima nama bagian yang terkait dengan file bernama. Buffer diisi dengan satu atau beberapa string yang dihentikan null; string terakhir diikuti oleh karakter null kedua.
[in] nSize
Ukuran buffer yang diacu oleh parameter lpszReturnBuffer , dalam karakter.
[in] lpFileName
Nama file inisialisasi. Jika parameter ini NULL, fungsi mencari file Win.ini. Jika parameter ini tidak berisi jalur lengkap ke file, sistem akan mencari file di direktori Windows.
Nilai kembali
Nilai yang dikembalikan menentukan jumlah karakter yang disalin ke buffer yang ditentukan, tidak termasuk karakter null yang mengakhiri. Jika buffer tidak cukup besar untuk berisi semua nama bagian yang terkait dengan file inisialisasi yang ditentukan, nilai yang dikembalikan sama dengan ukuran yang ditentukan oleh nSize dikurangi dua.
Keterangan
Operasi ini bersifat atom; tidak ada pembaruan untuk file inisialisasi yang diizinkan saat nama bagian sedang disalin ke buffer.
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 kasus ini, fungsi mengambil informasi dari registri, bukan dari 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.
Persyaratan
| 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 |