SetupDiOpenClassRegKeyExW (setupapi.h)
Fungsi SetupDiOpenClassRegKeyEx membuka kunci registri kelas penyiapan perangkat , kunci registri kelas antarmuka perangkat , atau subkey kelas tertentu. Fungsi ini membuka kunci yang ditentukan pada komputer lokal atau pada komputer jarak jauh.
Sintaks
WINSETUPAPI HKEY SetupDiOpenClassRegKeyExW(
[in, optional] const GUID *ClassGuid,
[in] REGSAM samDesired,
[in] DWORD Flags,
[in, optional] PCWSTR MachineName,
PVOID Reserved
);
Parameter
[in, optional] ClassGuid
Pointer ke GUID kelas yang kunci registrinya akan dibuka. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini NULL, akar pohon kelas (HKLM\SYSTEM\CurrentControlSet\Control\Class) dibuka.
[in] samDesired
Akses keamanan registri untuk kunci yang akan dibuka. Untuk informasi tentang nilai akses keamanan registri jenis REGSAM, lihat dokumentasi Microsoft Windows SDK.
[in] Flags
Jenis kunci registri yang akan dibuka, yang ditentukan oleh salah satu dari berikut ini:
DIOCR_INSTALLER
Buka kunci kelas penyiapan. Jika ClassGuidADALAH NULL, buka kunci akar cabang penginstal kelas.
DIOCR_INTERFACE
Buka kunci kelas antarmuka. Jika ClassGuidADALAH NULL, buka kunci akar cabang kelas antarmuka.
[in, optional] MachineName
Secara opsional menunjuk ke string yang berisi nama komputer jarak jauh untuk membuka kunci yang ditentukan.
Perhatian
Menggunakan fungsi ini untuk mengakses komputer jarak jauh tidak didukung dimulai dengan Windows 8 dan Windows Server 2012, karena fungsi ini telah dihapus.
Reserved
Dicadangkan. Harus NULL.
Mengembalikan nilai
SetupDiOpenClassRegKeyEx mengembalikan handel ke kunci registri yang dibuka di mana informasi tentang kelas penyiapan ini dapat disimpan/diambil.
Jika fungsi gagal, fungsi akan mengembalikan INVALID_HANDLE_VALUE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
Keterangan
Bergantung pada nilai yang diteruskan dalam parameter samDesired , mungkin perlu bagi pemanggil fungsi ini untuk menjadi anggota grup Administrator.
SetupDiOpenClassRegKeyEx tidak membuat kunci registri jika belum ada.
Penelepon fungsi ini harus menutup handel yang dikembalikan dari fungsi ini dengan memanggil RegCloseKey.
Catatan
Header setupapi.h mendefinisikan SetupDiOpenClassRegKeyEx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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 | Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru. |
| Target Platform | Desktop |
| Header | setupapi.h (termasuk Setupapi.h) |
| Pustaka | Setupapi.lib |