Bagikan melalui

Fungsi SHEnumValueW (shlwapi.h)

  • Artikel

Menghitung nilai kunci registri terbuka yang ditentukan.

Sintaks

LSTATUS SHEnumValueW(
  [in]                HKEY    hkey,
  [in]                DWORD   dwIndex,
                      PWSTR   pszValueName,
  [in, out, optional] LPDWORD pcchValueName,
  [out, optional]     LPDWORD pdwType,
                      void    *pvData,
  [in, out, optional] LPDWORD pcbData
);

Parameter

[in] hkey

Jenis: HKEY

Handel ke kunci yang saat ini terbuka, atau salah satu nilai yang telah ditentukan sebelumnya berikut ini.

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

[in] dwIndex

Jenis: DWORD

Indeks nilai yang akan diambil. Parameter ini harus nol untuk panggilan pertama dan dinaikkan untuk panggilan berikutnya.

pszValueName

Jenis: LPTSTR

Alamat buffer karakter yang menerima nama nilai enumerasi. Ukuran buffer ini ditentukan dalam pcchValueName.

[in, out, optional] pcchValueName

Jenis: LPDWORD

Alamat DWORD yang, pada entri, berisi ukuran buffer di pszValueName, dalam karakter. Saat keluar, ini berisi jumlah karakter yang disalin ke pszValueName.

[out, optional] pdwType

Jenis: LPDWORD

Alamat DWORD yang menerima jenis data nilai. Ini adalah nilai yang sama seperti yang dijelaskan di bawah parameter lpType dari RegEnumValue.

pvData

Jenis: LPVOID

Alamat buffer yang menerima data untuk entri nilai. Ukuran buffer ini ditentukan dalam pcbData. Parameter ini bisa NULL jika data tidak diperlukan.

[in, out, optional] pcbData

Jenis: LPDWORD

Alamat DWORD yang, pada entri, berisi ukuran buffer di pvData, dalam byte. Saat keluar, ini berisi jumlah byte yang disalin ke pvData.

Nilai kembali

Jenis: LSTATUS

Mengembalikan ERROR_SUCCESS jika berhasil, atau kode kesalahan bukan nol yang ditentukan dalam Winerror.h jika tidak. Anda dapat menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM untuk mengambil deskripsi tekstual tentang kesalahan.

Keterangan

Catatan

Header shlwapi.h mendefinisikan SHEnumValue sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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, Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header shlwapi.h
Pustaka Shlwapi.lib
DLL Shlwapi.dll (versi 4.71 atau yang lebih baru)