Fungsi SHDeleteEmptyKeyA (shlwapi.h)

Artikel
03/04/2024

Menghapus kunci kosong.

Sintaks

LSTATUS SHDeleteEmptyKeyA(
  [in]           HKEY   hkey,
  [in, optional] LPCSTR pszSubKey
);

Parameter

[in] hkey

Jenis: HKEY

Handel ke kunci registri terbuka, atau salah satu kunci yang telah ditentukan berikut:

HKEY_CLASSES_ROOT

HKEY_CURRENT_CONFIG

HKEY_CURRENT_USER

HKEY_LOCAL_MACHINE

HKEY_PERFORMANCE_DATA

HKEY_USERS

[in, optional] pszSubKey

Jenis: LPCTSTR

Alamat string yang dihentikan null yang menentukan nama kunci yang akan dihapus.

Nilai kembali

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

SHDeleteEmptyKey tidak menghapus kunci jika berisi subkunci atau nilai apa pun. Gunakan SHDeleteKey sebagai gantinya.

Atau, gunakan fungsi RegDeleteKey atau RegDeleteTree .

Catatan

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

Bagikan melalui