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

Vedi anche

SetupDiCreateDeviceInterfaceRegKey

SetupDiOpenDevRegKey