Fungsi SHRegGetValueFromHKCUHKLM (shlwapi.h)

[Fungsi ini tidak lagi didukung.]

Mendapatkan informasi yang ditentukan dari registri. Fungsi ini akan memeriksa HKEY_CURRENT_USER untuk informasi yang diminta dalam subkuncar yang ditentukan. Jika informasi tidak ada di bawah subtree HKEY_CURRENT_USER, fungsi memeriksa subtree HKEY_LOCAL_MACHINE untuk informasi yang sama.

Sintaks

LSTATUS SHRegGetValueFromHKCUHKLM(
  [in]      PCWSTR pwszKey,
  [in]      PCWSTR pwszValue,
  [in]      SRRF   srrfFlags,
  [out]     DWORD  *pdwType,
  [in]      void   *pvData,
  [in, out] DWORD  *pcbData
);

Parameter

[in] pwszKey

Jenis: PCWSTR

Penunjuk ke string Unicode yang dihentikan null yang menentukan jalur ke kunci registri.

[in] pwszValue

Jenis: PCWSTR

Penunjuk ke string Unicode yang dihentikan null yang menentukan nilai kunci. Nilai ini bisa NULL, dalam hal ini data diambil dari nilai Default.

[in] srrfFlags

Jenis: SRRF

Konstanta bendera SRRF . Jika lebih dari satu bendera digunakan, bendera dapat digabungkan menggunakan bitwise OR. Bendera ini digunakan untuk membatasi jenis data yang dikembalikan. Nilai ini tidak boleh 0.

[out] pdwType

Jenis: DWORD*

Ketika fungsi ini kembali, berisi penunjuk ke DWORD yang menerima kode yang menunjukkan jenis data yang disimpan dalam nilai yang ditentukan. Ini dapat diatur ke NULL jika tidak ada informasi jenis yang diinginkan. Jika nilai ini bukan NULL, dan bendera SRRF_NOEXPAND belum diatur, jenis data REG_EXPAND_SZ akan dikembalikan sebagai REG_SZ karena secara otomatis diperluas dalam metode ini.

[in] pvData

Jenis: LPCVOID

Penunjuk ke buffer yang berisi data nilai. Parameter ini bisa NULL jika data tidak diperlukan. Nilai ini harus berisi ukuran buffer pvData pada entri. Jika pvData adalah NULL (atau jika pvData bukan NULL, tetapi terlalu kecil dari buffer untuk menyimpan data registri), maka saat keluar akan berisi ukuran yang diperlukan untuk menyimpan data registri.

[in, out] pcbData

Jenis: DWORD*

Saat fungsi ini kembali, berisi penunjuk ke ukuran data, dalam byte.

Nilai kembali

Jenis: LONG

Jika berhasil, fungsi ini mengembalikan ERROR_SUCCESS dan semua parameter keluar yang diminta. Mengembalikan ERROR_MORE_DATA jika fungsi gagal karena ruang yang tidak memadai dalam pvData non-NULL yang disediakan. Dalam hal ini hanya pdwType dan pcbData yang mungkin berisi data yang valid, pvData tidak akan terdefinisi. Jika tidak, mengembalikan kode kesalahan bukan nol yang ditentukan dalam Winerror.h . Anda dapat menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM untuk mengambil deskripsi umum kesalahan.

Persyaratan

Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlwapi.h
DLL	Shlwapi.dll