SetupDiOpenClassRegKeyExA (setupapi.h)

2024-11-20

Fungsi SetupDiOpenClassRegKeyEx membuka kelas penyiapan perangkat kunci registri, kelas antarmuka perangkat kunci registri, atau subkuntang kelas tertentu. Fungsi ini membuka kunci yang ditentukan pada komputer lokal atau pada komputer jarak jauh.

Sintaksis

WINSETUPAPI HKEY SetupDiOpenClassRegKeyExA(
  [in, optional] const GUID *ClassGuid,
  [in]           REGSAM     samDesired,
  [in]           DWORD      Flags,
  [in, optional] PCSTR      MachineName,
                 PVOID      Reserved
);

Parameter

[in, optional] ClassGuid

Penunjuk ke GUID kelas yang kunci registrinya akan dibuka. Parameter ini bersifat opsional dan dapat 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 hal berikut:

DIOCR_INSTALLER

Buka kunci kelas penyiapan. Jika ClassGuidNULL, buka kunci akar cabang penginstal kelas.

DIOCR_INTERFACE

Buka kunci kelas antarmuka. Jika ClassGuidNULL, 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.

Hati

Menggunakan fungsi ini untuk mengakses komputer jarak jauh tidak didukung dimulai dengan Windows 8 dan Windows Server 2012, karena fungsionalitas ini telah dihapus.

Reserved

Dipesan. 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, panggil GetLastError.

Komentar

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.

Nota

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

Syarat	Nilai
klien minimum yang didukung	Tersedia di Microsoft Windows 2000 dan versi Windows yang lebih baru.
Platform Target	Desktop
Header	setupapi.h (termasuk Setupapi.h)
Pustaka	Setupapi.lib

Lihat juga

SetupDiCreateDeviceInterfaceRegKey

SetupDiOpenDevRegKey

Bagikan melalui