Fungsi SHRegCreateUSKeyA (shlwapi.h)

Artikel
08/26/2023

Membuat atau membuka subkunci registri dalam subtree khusus pengguna (HKEY_CURRENT_USER atau HKEY_LOCAL_MACHINE).

Sintaks

LSTATUS SHRegCreateUSKeyA(
  [in]           LPCSTR  pszPath,
  [in]           REGSAM  samDesired,
  [in, optional] HUSKEY  hRelativeUSKey,
  [out]          PHUSKEY phNewUSKey,
  [in]           DWORD   dwFlags
);

Parameter

[in] pszPath

Jenis: LPCTSTR

Penunjuk ke string yang dihentikan null yang berisi subkunci yang akan dibuat atau dibuka. Jika nilai dengan nama ini sudah ada di subkunji, nilai tersebut akan dibuka.

[in] samDesired

Jenis: REGSAM

Akses keamanan yang diinginkan. Untuk informasi selengkapnya tentang akses keamanan, lihat REGSAM.

[in, optional] hRelativeUSKey

Jenis: HUSKEY

Kunci yang akan digunakan sebagai dasar untuk jalur relatif. Jika pszPath adalah jalur relatif, kunci yang ditentukannya akan relatif terhadap hRelativeUSKey. Jika pszPath adalah jalur absolut, atur hRelativeUSKey ke NULL. Kunci kemudian akan dibuat di bawah HKEY_LOCAL_MACHINE atau HKEY_CURRENT_USER, tergantung nilai dwFlags.

[out] phNewUSKey

Jenis: PHUSKEY

Pointer ke HUSKEY yang akan menerima handel ke kunci baru.

[in] dwFlags

Jenis: DWORD

Kunci dasar tempat kunci harus dibuka. Ini bisa menjadi satu atau beberapa nilai berikut.

SHREGSET_HKCU

Buat/buka kunci di bawah HKEY_CURRENT_USER. Hanya membuat kunci jika kosong.

SHREGSET_FORCE_HKCU

Buat/buka kunci di bawah HKEY_CURRENT_USER. Membuat kunci meskipun tidak kosong.

SHREGSET_HKLM

Buat/buka kunci di bawah HKEY_LOCAL_MACHINE. Hanya membuat kunci jika kosong.

SHREGSET_FORCE_HKLM

Buat/buka kunci di bawah HKEY_LOCAL_MACHINE. Membuat kunci meskipun tidak kosong.

SHREGSET_DEFAULT

Buat/buka kunci di bawah HKEY_CURRENT_USER (paksa) dan HKEY_LOCAL_MACHINE (hanya jika kosong). Bendera ini setara dengan (SHREGSET_HKLM SHREGSET_FORCE_HKCU | ).

Menampilkan nilai

Jenis: LSTATUS

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

Keterangan

Jika Anda ingin menulis nilai ke kunci baru, gunakan SHRegWriteUSValue untuk menulis setiap nilai, melewati handel HUSKEY yang dikembalikan melalui phNewUSKey. Setelah selesai, tutup kunci registri khusus pengguna dengan SHRegCloseUSKey.

Catatan

Header shlwapi.h mendefinisikan SHRegCreateUSKey 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


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)

Bagikan melalui