Funzione SetupDiOpenDevRegKey (setupapi.h)
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) |