SetupDiOpenClassRegKeyExA (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 SetupDiOpenClassRegKeyExA(
  [in, optional] const GUID *ClassGuid,
  [in]           REGSAM     samDesired,
  [in]           DWORD      Flags,
  [in, optional] PCSTR      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.

Nilai kembali

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

Lihat juga

SetupDiCreateDeviceInterfaceRegKey

SetupDiOpenDevRegKey