Funzione SetupDiOpenClassRegKey (setupapi.h)

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

Vedi anche

SetupDiOpenClassRegKeyEx

SetupDiOpenDevRegKey