Fungsi SHRegDeleteEmptyUSKeyA (shlwapi.h)

Artikel
20/11/2024

Menghapus subkuntang registri kosong dalam subtree khusus pengguna (HKEY_CURRENT_USER atau HKEY_LOCAL_MACHINE).

Sintaksis

C++

LSTATUS SHRegDeleteEmptyUSKeyA(
  [in] HUSKEY         hUSKey,
  [in] LPCSTR         pszSubKey,
  [in] SHREGDEL_FLAGS delRegFlags
);

Parameter

[in] hUSKey

Jenis: HUSKEY

Handel ke subkuntang registri yang saat ini terbuka. Subkunjuk harus telah dibuka dengan hak akses KEY_SET_VALUE. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses.

Handel ini dapat diperoleh melalui fungsi SHRegOpenUSKey.

[in] pszSubKey

Jenis: LPCSTR

Penunjuk ke string yang dihentikan null yang menentukan subkunci registri kosong yang ditentukan pengguna untuk dihapus.

[in] delRegFlags

Jenis: SHREGDEL_FLAGS

Salah satu SHREGDEL_FLAGS yang menentukan dari kunci dasar mana subkuncar akan dihapus.

Mengembalikan nilai

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 umum tentang kesalahan tersebut.

Komentar

Catatan

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

Lihat juga

SHRegDeleteUSValue

Bagikan melalui