SetupDiOpenClassRegKey (setupapi.h)
Fungsi SetupDiOpenClassRegKey membuka kunci registri kelas penyiapan atau subkunjung kelas tertentu.
Sintaks
WINSETUPAPI HKEY SetupDiOpenClassRegKey(
[in, optional] const GUID *ClassGuid,
[in] REGSAM samDesired
);
Parameter
[in, optional] ClassGuid
Penunjuk ke GUID kelas penyiapan yang kuncinya akan dibuka. Parameter ini bersifat opsional dan dapat berupa NULL. Jika parameter ini NULL, akar pohon kelas penyiapan (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.
Nilai kembali
Jika fungsi berhasil, fungsi 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.
Fungsi ini tidak membuat kunci registri jika belum ada.
Handel yang dikembalikan dari fungsi ini harus ditutup dengan memanggil RegCloseKey.
Untuk membuka kunci registri kelas antarmuka atau subkunjung kelas antarmuka tertentu, panggil SetupDiOpenClassRegKeyEx.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru. |
| Target Platform | DesktopUntuk universal, panggil CM_Open_Class_Key |
| Header | setupapi.h (termasuk Setupapi.h) |
| Pustaka | Setupapi.lib |
| DLL | Setupapi.dll |