Condividi tramite

Funzione SetupDiOpenClassRegKey (setupapi.h)

  • Articolo

La funzione SetupDiOpenClassRegKey apre la chiave del Registro di sistema della classe di installazione o la sottochiave di una classe specifica.

Sintassi

WINSETUPAPI HKEY SetupDiOpenClassRegKey(
  [in, optional] const GUID *ClassGuid,
  [in]           REGSAM     samDesired
);

Parametri

[in, optional] ClassGuid

Puntatore al GUID della classe di installazione la cui chiave deve essere aperta. Questo parametro è facoltativo e può essere NULL. Se questo parametro è NULL, viene aperta la radice dell'albero delle classi di installazione (HKLM\SYSTEM\CurrentControlSet\Control\Class).

[in] samDesired

Accesso alla sicurezza del Registro di sistema per la chiave da aprire. Per informazioni sui valori di accesso alla sicurezza del Registro di sistema di tipo REGSAM, vedere la documentazione di Microsoft Windows SDK.

Valore restituito

Se la funzione ha esito positivo, restituisce un handle a una chiave del Registro di sistema aperta in cui è possibile archiviare/recuperare informazioni su questa classe di installazione.

Se la funzione ha esito negativo, restituisce INVALID_HANDLE_VALUE. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

A seconda del valore passato nel parametro samDesired , potrebbe essere necessario che il chiamante di questa funzione sia membro del gruppo Administrators.

Questa funzione non crea una chiave del Registro di sistema se non esiste già.

L'handle restituito da questa funzione deve essere chiuso chiamando RegCloseKey.

Per aprire la chiave del Registro di sistema della classe di interfaccia o una sottochiave della classe di interfaccia specifica, chiamare SetupDiOpenClassRegKeyEx.

Requisiti

Requisito Valore
Client minimo supportato Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione DesktopFor universal, chiamare CM_Open_Class_Key
Intestazione setupapi.h (include Setupapi.h)
Libreria Setupapi.lib
DLL Setupapi.dll

Vedi anche

SetupDiOpenClassRegKeyEx

SetupDiOpenDevRegKey