Funzione SetupDiOpenClassRegKeyExA (setupapi.h)
La funzione SetupDiOpenClassRegKeyEx apre la chiave del Registro di sistema della classe di installazione del dispositivo , la chiave del Registro di sistema della classe dell'interfaccia del dispositivo o la sottochiave di una classe specifica. Questa funzione apre la chiave specificata nel computer locale o in un computer remoto.
Sintassi
WINSETUPAPI HKEY SetupDiOpenClassRegKeyExA(
[in, optional] const GUID *ClassGuid,
[in] REGSAM samDesired,
[in] DWORD Flags,
[in, optional] PCSTR MachineName,
PVOID Reserved
);
Parametri
[in, optional] ClassGuid
Puntatore al GUID della classe la cui chiave del Registro di sistema deve essere aperta. Questo parametro è facoltativo e può essere NULL. Se questo parametro è NULL, viene aperta la radice dell'albero della classe (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.
[in] Flags
Tipo di chiave del Registro di sistema da aprire, specificato da uno dei seguenti:
DIOCR_INSTALLER
Aprire una chiave della classe di installazione. Se ClassGuid è NULL, aprire la chiave radice del ramo del programma di installazione della classe.
DIOCR_INTERFACE
Aprire una chiave della classe di interfaccia. Se ClassGuid è NULL, aprire la chiave radice del ramo della classe di interfaccia.
[in, optional] MachineName
Facoltativamente, punta a una stringa contenente il nome di un computer remoto in cui aprire la chiave specificata.
Attenzione
L'uso di questa funzione per accedere ai computer remoti non è supportato a partire da Windows 8 e Windows Server 2012, perché questa funzionalità è stata rimossa.
Reserved
Riservato. Deve essere NULL.
Valore restituito
SetupDiOpenClassRegKeyEx 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.
SetupDiOpenClassRegKeyEx non crea una chiave del Registro di sistema se non esiste già.
I chiamanti di questa funzione devono chiudere l'handle restituito da questa funzione chiamando RegCloseKey.
Nota
L'intestazione setupapi.h definisce SetupDiOpenClassRegKeyEx come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (include Setupapi.h) |
| Libreria | Setupapi.lib |