Fungsi ORGetValue

Mengambil jenis dan data untuk nilai registri yang ditentukan dalam sarang registri offline.

Sintaks

DWORD ORGetValue(
  _In_        ORHKEY Handle,
  _In_opt_    PCWSTR lpSubKey,
  _In_opt_    PCWSTR lpValue,
  _Out_opt_   PDWORD pdwType,
  _Out_opt_   PVOID  pvData,
  _Inout_opt_ PDWORD pcbData
);

Parameter

Handel [in]

Handel ke kunci registri terbuka di sarang registri offline.

lpSubKey [dalam, opsional]

Nama kunci registri. Kunci ini harus berupa subkuntangan kunci yang ditentukan oleh parameter Handel . Parameter ini bisa NULL.

Nama kunci tidak peka huruf besar/kecil.

lpValue [in, opsional]

Nama nilai registri. Jika parameter ini adalah NULL atau string kosong, "", fungsi mengambil jenis dan data untuk kunci yang tidak bernama atau nilai default, jika ada. Untuk informasi selengkapnya, lihat Batas Ukuran Elemen Registri.

Kunci tidak secara otomatis memiliki nilai yang tidak disebutkan namanya atau default. Nilai yang tidak disebutkan namanya bisa dari jenis apa pun.

Nama nilai tidak peka huruf besar/kecil.

pdwType [keluar, opsional]

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 berupa NULL jika jenisnya tidak diperlukan.

pvData [keluar, opsional]

Penunjuk ke buffer yang menerima data nilai. Parameter ini bisa NULL jika data tidak diperlukan.

Jika data adalah string, fungsi akan memeriksa karakter null yang mengakhiri. Jika tidak ditemukan, string disimpan dengan terminator null jika buffer cukup besar untuk mengakomodasi karakter tambahan. Jika tidak, fungsi gagal dan mengembalikan ERROR_MORE_DATA.

pcbData [masuk, keluar, opsional]

Penunjuk ke variabel yang menentukan ukuran buffer yang diacu oleh parameter pvData , dalam byte. Ketika fungsi kembali, variabel ini berisi ukuran data yang disalin ke pvData.

Parameter pcbData dapat berupa NULL hanya jika pvData adalah NULL.

Jika data memiliki jenis REG_SZ, REG_MULTI_SZ, atau REG_EXPAND_SZ, ukuran ini menyertakan karakter atau karakter null yang mengakhiri. Untuk informasi selengkapnya, lihat Keterangan.

Jika buffer yang ditentukan oleh parameter pvData tidak cukup besar untuk menyimpan data, fungsi mengembalikan ERROR_MORE_DATA dan menyimpan ukuran buffer yang diperlukan dalam variabel yang ditunjukkan oleh pcbData. Dalam hal ini, konten buffer pvData tidak terdefinisi.

Jika pvData adalah NULL, dan pcbDatanon-NULL, fungsi mengembalikan ERROR_SUCCESS dan menyimpan ukuran data, dalam byte, dalam variabel yang diacu oleh pcbData. Ini memungkinkan aplikasi untuk menentukan cara terbaik untuk mengalokasikan buffer untuk data nilai.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan bukan nol yang ditentukan dalam Winerror.h. Anda dapat menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM untuk mendapatkan deskripsi umum tentang kesalahan tersebut.

Keterangan

Aplikasi biasanya memanggil fungsi OREnumValue untuk menentukan nama nilai lalu memanggil fungsi ORGetValue untuk mengambil data untuk nama tersebut.

Persyaratan

Persyaratan	Nilai
Redistribusi	Pustaka Windows Offline Registry versi 1.0 atau yang lebih baru
Header	Offreg.h
DLL	Offreg.dll

Lihat juga

ORCreateKey

OREnumKey

OREnumValue

OROpenKey

ORQueryInfoKey