Fungsi GetProfileIntA (winbase.h)
Mengambil bilangan bulat dari kunci di bagian yang ditentukan dari file Win.ini.
Sintaks
UINT GetProfileIntA(
[in] LPCSTR lpAppName,
[in] LPCSTR lpKeyName,
[in] INT nDefault
);
Parameter
[in] lpAppName
Nama bagian yang berisi nama kunci.
[in] lpKeyName
Nama kunci yang nilainya akan diambil. Nilai ini dalam bentuk string; fungsi GetProfileInt mengonversi string menjadi bilangan bulat dan mengembalikan bilangan bulat.
[in] nDefault
Nilai default yang akan dikembalikan jika nama kunci tidak dapat ditemukan dalam file inisialisasi.
Nilai kembali
Nilai yang dikembalikan adalah bilangan bulat yang setara dengan string yang mengikuti nama kunci di Win.ini. Jika fungsi tidak dapat menemukan kunci, nilai yang dikembalikan adalah nilai default. Jika nilai kunci kurang dari nol, nilai yang dikembalikan adalah nol.
Keterangan
Jika nama kunci terdiri dari digit diikuti oleh karakter yang bukan numerik, fungsi hanya mengembalikan nilai digit. Misalnya, fungsi mengembalikan 102 untuk baris berikut: KeyName=102abc.
Windows Server 2003 dan Windows XP/2000: Panggilan ke fungsi profil dapat dipetakan ke registri alih-alih ke file inisialisasi. Pemetaan ini terjadi ketika file dan bagian inisialisasi ditentukan dalam registri di bawah kunci berikut:HKEY_LOCAL_MACHINE\Software\Microsoft\Windows NT\CurrentVersion\IniFileMapping
Ketika operasi telah dipetakan, fungsi GetProfileInt 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 subkunjuk dengan nama ini, atau nama tidak akan ada sebagai nilai atau subkun tangan.
- 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 subkey, 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 GetProfileInt 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 |