Funzione SetupDiOpenDevRegKey (setupapi.h)

Articolo
03/15/2023

La funzione SetupDiOpenDevRegKey apre una chiave del Registro di sistema per informazioni di configurazione specifiche del dispositivo.

Sintassi

WINSETUPAPI HKEY SetupDiOpenDevRegKey(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData,
  [in] DWORD            Scope,
  [in] DWORD            HwProfile,
  [in] DWORD            KeyType,
  [in] REGSAM           samDesired
);

Parametri

[in] DeviceInfoSet

Handle per il set di informazioni sul dispositivo che contiene un elemento informativo del dispositivo che rappresenta il dispositivo per cui aprire una chiave del Registro di sistema.

[in] DeviceInfoData

Puntatore a una struttura SP_DEVINFO_DATA che specifica l'elemento informazioni sul dispositivo in DeviceInfoSet.

[in] Scope

Ambito della chiave del Registro di sistema da aprire. L'ambito determina la posizione in cui vengono archiviate le informazioni. L'ambito può essere globale o specifico di un profilo hardware. L'ambito viene specificato da uno dei valori seguenti:

DICS_FLAG_GLOBAL

Aprire una chiave per archiviare le informazioni di configurazione globali. Queste informazioni non sono specifiche di un determinato profilo hardware. Verrà aperta una chiave radicata in HKEY_LOCAL_MACHINE. La chiave esatta aperta dipende dal valore del parametro KeyType .

DICS_FLAG_CONFIGSPECIFIC

Aprire una chiave per archiviare informazioni di configurazione specifiche del profilo hardware. Questa chiave è radicata in uno dei rami specifici del profilo hardware, anziché HKEY_LOCAL_MACHINE. La chiave esatta aperta dipende dal valore del parametro KeyType .

[in] HwProfile

Valore del profilo hardware, impostato come indicato di seguito:

Se Scope è impostato su DICS_FLAG_CONFIGSPECIFIC, HwProfile specifica il profilo hardware della chiave da aprire.
Se HwProfile è 0, viene aperta la chiave per il profilo hardware corrente.
Se Scope è DICS_FLAG_GLOBAL, HwProfile viene ignorato.

[in] KeyType

Tipo di chiave di archiviazione del Registro di sistema da aprire, che può essere uno dei valori seguenti:

DIREG_DEV

Aprire una chiave hardware per il dispositivo.

DIREG_DRV

Aprire una chiave software per il dispositivo.

Per altre informazioni sulle chiavi hardware e software di un dispositivo, vedere Alberi e chiavi del Registro di sistema per dispositivi e driver.

[in] samDesired

Accesso alla sicurezza del Registro di sistema necessario per la chiave richiesta. Per informazioni sui valori di accesso alla sicurezza del Registro di sistema di tipo REGSAM, vedere la documentazione 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 i dati di configurazione privati relativi a questa istanza del dispositivo.

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.

Chiudere l'handle restituito da questa funzione chiamando RegCloseKey.

L'istanza del dispositivo specificata deve essere registrata prima che questa funzione venga chiamata. Tuttavia, tenere presente che il sistema operativo registra automaticamente le istanze del dispositivo PnP. Per informazioni su come registrare istanze di dispositivi non PnP, vedere SetupDiRegisterDeviceInfo.

Requisiti


Client minimo supportato	Disponibile in Microsoft Windows 2000 e versioni successive di Windows.
Piattaforma di destinazione	DesktopFor universal, chiamare CM_Open_DevNode_Key
Intestazione	setupapi.h (includere Setupapi.h)
Libreria	Setupapi.lib
DLL	Setupapi.dll
Set di API	ext-ms-win-setupapi-classinstallers-l1-1-2 (introdotta in Windows 10, versione 10.0.14393)