Fungsi RegCopyTreeA (winreg.h)

Artikel
11/20/2024

Menyalin kunci registri yang ditentukan, bersama dengan nilai dan subkuntahnya, ke kunci tujuan yang ditentukan.

Sintaksis

LSTATUS RegCopyTreeA(
  [in]           HKEY   hKeySrc,
  [in, optional] LPCSTR lpSubKey,
  [in]           HKEY   hKeyDest
);

Parameter

[in] hKeySrc

Handel ke kunci registri terbuka. Kunci harus dibuka dengan hak akses KEY_READ. Untuk informasi selengkapnya, lihat Keamanan Kunci Registri dan Hak Akses.

Handel ini dikembalikan oleh fungsi RegCreateKey Ex atau RegOpenKeyEx, atau dapat menjadi salah satu kunci yang telah ditentukan sebelumnya.

[in, optional] lpSubKey

Nama kunci. Kunci ini harus berupa subkunji kunci yang diidentifikasi oleh parameter hKeySrc . Parameter ini juga dapat null.

[in] hKeyDest

Handel ke kunci tujuan. Proses panggilan harus memiliki akses KEY_CREATE_SUB_KEY ke kunci.

Handel ini dikembalikan oleh fungsi RegCreateKey Ex atau RegOpenKeyEx, atau dapat menjadi salah satu kunci yang telah ditentukan sebelumnya.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan adalah ERROR_SUCCESS.

Jika fungsi gagal, nilai pengembalian adalah kode kesalahan nonzero yang ditentukan dalam Winerror.h. Anda dapat menggunakan fungsi FormatMessage dengan bendera FORMAT_MESSAGE_FROM_SYSTEM untuk mendapatkan deskripsi umum tentang kesalahan tersebut.

Komentar

Fungsi ini juga menyalin deskriptor keamanan untuk kunci.

Untuk mengkompilasi aplikasi yang menggunakan fungsi ini, tentukan _WIN32_WINNT sebagai 0x0600 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Nota

Header winreg.h mendefinisikan RegCopyTree sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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 Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Platform Target	Windows
Header	winreg.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll

Lihat juga

Fungsi Registri

Bagikan melalui