Fungsi RegConnectRegistryA (winreg.h)
Membuat koneksi ke kunci registri yang telah ditentukan sebelumnya pada komputer lain.
Sintaks
LSTATUS RegConnectRegistryA(
[in, optional] LPCSTR lpMachineName,
[in] HKEY hKey,
[out] PHKEY phkResult
);
Parameter
[in, optional] lpMachineName
Nama komputer jarak jauh. String memiliki formulir berikut:
\\nama komputer
Pemanggil harus memiliki akses ke komputer jarak jauh atau fungsi gagal.
Jika parameter ini NULL, nama komputer lokal akan digunakan.
[in] hKey
Handel registri yang telah ditentukan sebelumnya. Parameter ini bisa menjadi salah satu kunci yang telah ditentukan sebelumnya berikut pada komputer jarak jauh.
HKEY_USERSHKEY_PERFORMANCE_DATA HKEY_LOCAL_MACHINE
[out] phkResult
Penunjuk ke variabel yang menerima handel kunci yang mengidentifikasi handel yang telah ditentukan sebelumnya pada komputer jarak jauh.
Nilai kembali
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.
Keterangan
RegConnectRegistry mengharuskan layanan Remote Registry berjalan di komputer jarak jauh. Secara default, layanan ini dikonfigurasi untuk dimulai secara manual. Untuk mengonfigurasi layanan Remote Registry agar dimulai secara otomatis, jalankan Services.msc dan ubah Jenis Startup layanan menjadi Otomatis.
Windows Server 2003 dan Windows XP/2000: Layanan Remote Registry dikonfigurasi untuk memulai secara otomatis secara default.
Ketika handel yang dikembalikan oleh RegConnectRegistry tidak lagi diperlukan, handel harus ditutup dengan memanggil RegCloseKey.
Jika komputer bergabung ke grup kerja dan kebijakan "Paksa masuk jaringan menggunakan akun lokal untuk mengautentikasi sebagai Tamu" diaktifkan, fungsi gagal. Perhatikan bahwa kebijakan ini diaktifkan secara default jika komputer bergabung ke grup kerja.
Jika pengguna saat ini tidak memiliki akses yang tepat ke komputer jarak jauh, panggilan ke RegConnectRegistry gagal. Untuk menyambungkan ke registri jarak jauh, panggil LogonUser dengan LOGON32_LOGON_NEW_CREDENTIALS dan ImpersonateLoggedOnUser sebelum memanggil RegConnectRegistry.
Windows 2000: Salah satu solusi yang mungkin adalah membuat sesi ke berbagi administratif seperti IPC$ menggunakan serangkaian kredensial yang berbeda. Untuk menentukan kredensial selain kredensial pengguna saat ini, gunakan fungsi WNetAddConnection2 untuk menyambungkan ke berbagi. Setelah Anda selesai mengakses registri, batalkan koneksi.
Windows XP Home Edition: Anda tidak dapat menggunakan fungsi ini untuk menyambung ke komputer jarak jauh yang menjalankan Windows XP Home Edition. Fungsi ini bekerja dengan nama komputer lokal meskipun menjalankan Windows XP Home Edition karena ini melewati lapisan autentikasi.
Catatan
Header winreg.h mendefinisikan RegConnectRegistry 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 [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | winreg.h (termasuk Windows.h) |
| Pustaka | Advapi32.lib |
| DLL | Advapi32.dll |