Funzione SetupDiOpenClassRegKeyExW (setupapi.h)

Articolo
11/20/2024

La funzione setupDiOpenClassRegKeyEx apre la classe di installazione del dispositivo chiave del Registro di sistema, la classe dell'interfaccia del dispositivo chiave del Registro di sistema o la sottochiave di una classe specifica. Questa funzione apre la chiave specificata nel computer locale o in un computer remoto.

Sintassi

WINSETUPAPI HKEY SetupDiOpenClassRegKeyExW(
  [in, optional] const GUID *ClassGuid,
  [in]           REGSAM     samDesired,
  [in]           DWORD      Flags,
  [in, optional] PCWSTR     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 delle classi (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.

Cautela

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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

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

Vedere anche

SetupDiCreateDeviceInterfaceRegKey

SetupDiOpenDevRegKey

Condividi tramite