Fungsi ORDeleteKey

Artikel
06/13/2023

Menghapus subkuntang dan nilainya dari sarang registri offline.

Sintaks

DWORD ORDeleteKey(
  _In_     ORHKEY Handle,
  _In_opt_ PCWSTR lpSubKey
);

Parameter

Handel [in]

Handel ke kunci registri terbuka di sarang registri offline. Handel ini dikembalikan oleh fungsi ORCreateKey atau OROpenKey .

lpSubKey [dalam, opsional]

Nama kunci yang akan dihapus. Ini harus berupa subkuntangan dari kunci yang diidentifikasi Handle , tetapi tidak dapat memiliki subkunjud.

Jika subkuntai tidak ada, fungsi akan mengembalikan ERROR_NOT_FOUND.

Jika parameter ini ADALAH NULL, fungsi akan menghapus kunci yang ditentukan oleh parameter Handle . Jika kunci yang ditentukan oleh parameter Handel adalah kunci akar sarang, fungsi mengembalikan ERROR_INVALID_PARAMETER.

Nama kunci tidak peka huruf besar/kecil.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai yang dikembalikan adalah kode kesalahan bukan nol yang ditentukan dalam Winerror.h. Anda dapat menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM untuk mendapatkan deskripsi umum tentang kesalahan tersebut. Kemungkinan kode kesalahan meliputi yang berikut ini:

Jika subkuntangan yang ditentukan tidak ada, fungsi akan mengembalikan ERROR_FILE_NOT_FOUND.
Jika subkuntang yang ditentukan adalah kunci akar sarang registri, fungsi mengembalikan ERROR_INVALID_PARAMETER.
Jika subkunjen yang ditentukan memiliki subkunjud, fungsi akan mengembalikan ERROR_KEY_HAS_CHILDREN.

Keterangan

Jika ada kunci registri yang ditentukan, kunci tersebut ditandai sebagai dihapus. Kunci yang dihapus tidak dihapus hingga handel terakhir ditutup.

Kunci yang akan dihapus tidak boleh memiliki subkuntangan. Untuk menghapus kunci dan semua subkuncinya, gunakan fungsi OREnumKey untuk menghitung subkunci dan menghapusnya satu per satu.

Hanya fungsi ORCloseKey yang dapat dipanggil pada kunci yang dihapus; semua operasi registri offline lainnya gagal. Jika kunci yang dihapus dibuat secara eksplisit dengan memanggil ORCreateKey, sumber daya yang terkait dengan kunci dirilis saat handel terakhir ke kunci yang dihapus ditutup.

Persyaratan

Persyaratan	Nilai
Redistribusi	Pustaka Windows Offline Registry versi 1.0 atau yang lebih baru
Header	Offreg.h
DLL	Offreg.dll

Lihat juga

ORCloseKey
ORCreateKey
OREnumKey
OROpenKey

Bagikan melalui