Fungsi RegGetValueA (winreg.h)
Mengambil jenis dan data untuk nilai registri yang ditentukan.
Sintaksis
LSTATUS RegGetValueA(
[in] HKEY hkey,
[in, optional] LPCSTR lpSubKey,
[in, optional] LPCSTR lpValue,
[in, optional] DWORD dwFlags,
[out, optional] LPDWORD pdwType,
[out, optional] PVOID pvData,
[in, out, optional] LPDWORD pcbData
);
Parameter
[in] hkey
Handel ke kunci registri terbuka. Kunci harus dibuka dengan hak akses KEY_QUERY_VALUE. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses.
Handel ini dikembalikan oleh RegCreateKeyEx, RegCreateKeyTransacted, RegOpenKeyEx, atau fungsi RegOpenKeyTransacted. Ini juga bisa menjadi salah satu kunci berikut yang telah ditentukan sebelumnya:
- HKEY_CLASSES_ROOT
- HKEY_CURRENT_CONFIG
- HKEY_CURRENT_USER
- HKEY_LOCAL_MACHINE
- HKEY_PERFORMANCE_DATA
- HKEY_PERFORMANCE_NLSTEXT
- HKEY_PERFORMANCE_TEXT
- HKEY_USERS
[in, optional] lpSubKey
Jalur kunci registri relatif terhadap kunci yang ditentukan oleh parameter hkey
Jalur tidak peka huruf besar/kecil.
Jika parameter ini NULL atau string kosong, "", nilai akan dibaca dari kunci yang ditentukan oleh hkey itu sendiri.
[in, optional] lpValue
Nama nilai registri.
Jika parameter ini NULL atau string kosong, "", fungsi mengambil jenis dan data untuk nilai kunci yang tidak disebutkan namanya atau default, jika ada. Kunci tidak secara otomatis memiliki nilai yang tidak disebutkan namanya atau default, dan nilai yang tidak disebutkan namanya bisa dari jenis apa pun.
Untuk informasi selengkapnya, lihat Batas Ukuran Elemen Registri.
[in, optional] dwFlags
Bendera yang membatasi jenis data nilai yang akan dikueri. Jika jenis data nilai tidak memenuhi kriteria ini, fungsi gagal. Parameter ini bisa berupa satu atau beberapa nilai berikut.
Parameter ini juga dapat menyertakan satu atau beberapa nilai berikut.
Nilai | Arti |
---|---|
|
Jangan memperluas string lingkungan secara otomatis jika nilainya berjenis REG_EXPAND_SZ. |
|
Jika pvData tidak null, atur konten buffer ke nol pada kegagalan. |
|
Jika lpSubKey tidak null, buka subkunjuk yang lpSubKey tentukan dengan hak akses KEY_WOW64_64KEY.
Untuk informasi tentang hak akses ini, lihat Keamanan Kunci Registri dan Hak Akses.
Anda tidak dapat menentukan RRF_SUBKEY_WOW6464KEY dalam kombinasi dengan RRF_SUBKEY_WOW6432KEY. |
|
Jika lpSubKey tidak NULL, buka subkunjuk yang lpSubKey tentukan dengan hak akses KEY_WOW64_32KEY.
Untuk informasi tentang hak akses ini, lihat Keamanan Kunci Registri dan Hak Akses.
Anda tidak dapat menentukan RRF_SUBKEY_WOW6432KEY dalam kombinasi dengan RRF_SUBKEY_WOW6464KEY. |
[out, optional] pdwType
Penunjuk ke variabel yang menerima kode yang menunjukkan jenis data yang disimpan dalam nilai yang ditentukan. Untuk daftar kode jenis yang mungkin, lihat Jenis Nilai Registri . Parameter ini dapat null jika jenis tidak diperlukan.
[out, optional] pvData
Penunjuk ke buffer yang menerima data nilai. Parameter ini dapat NULL jika data tidak diperlukan.
Jika data adalah string, fungsi memeriksa karakter null
[in, out, optional] pcbData
Penunjuk ke variabel yang menentukan ukuran buffer yang ditujukkan oleh parameter pvData
Parameter pcbData
Jika data memiliki jenis REG_SZ, REG_MULTI_SZ, atau REG_EXPAND_SZ, ukuran ini mencakup karakter atau karakter null
Jika buffer yang ditentukan oleh parameter pvData
Jika
Jika
Mengembalikan nilai
Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.
Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan sistem .
Jika pvData buffer terlalu kecil untuk menerima nilai, fungsi akan mengembalikan ERROR_MORE_DATA.
Jika nilai registri lpValue tidak ada, fungsi akan mengembalikan ERROR_FILE_NOT_FOUND.
Jika dwFlags menentukan kombinasi RRF_SUBKEY_WOW6464KEY dan RRF_SUBKEY_WOW6432KEY, fungsi akan mengembalikan ERROR_INVALID_PARAMETER.
Komentar
Aplikasi biasanya memanggil RegEnumValue
Jika data memiliki REG_SZ, REG_MULTI_SZ atau jenis REG_EXPAND_SZ, dan versi ANSI dari fungsi ini digunakan (baik dengan secara eksplisit memanggil
Saat memanggil fungsi ini dengan hkey diatur ke handel HKEY_PERFORMANCE_DATA dan string nilai objek tertentu, struktur data yang dikembalikan terkadang memiliki objek yang tidak diminta. Jangan terkejut; ini adalah perilaku normal. Anda harus selalu berharap untuk memandu struktur data yang dikembalikan untuk mencari objek yang diminta.
Perhatikan bahwa operasi yang mengakses kunci registri tertentu dialihkan. Untuk informasi selengkapnya, lihat Virtualisasi Registri
Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.
Nota
Header winreg.h mendefinisikan RegGetValue sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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
Syarat | Nilai |
---|---|
klien minimum yang didukung | Windows Vista, Windows XP Professional x64 Edition |
server minimum yang didukung |
Windows Server 2008, Windows Server 2003 dengan SP1 |
Platform Target |
Windows |
Header |
winreg.h (termasuk Windows.h) |
Pustaka |
Advapi32.lib |
DLL |
Advapi32.dll |
Lihat juga
Fungsi Registri
Gambaran Umum