Funzione SetupDiCreateDeviceInterfaceRegKeyA (setupapi.h)
La funzione SetupDiCreateDeviceInterfaceRegKey crea una chiave del Registro di sistema per archiviare informazioni su un'interfaccia del dispositivo e restituisce un handle alla chiave.
Sintassi
WINSETUPAPI HKEY SetupDiCreateDeviceInterfaceRegKeyA(
[in] HDEVINFO DeviceInfoSet,
[in] PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
DWORD Reserved,
[in] REGSAM samDesired,
[in, optional] HINF InfHandle,
[in, optional] PCSTR InfSectionName
);
Parametri
[in] DeviceInfoSet
Handle per un set di informazioni sul dispositivo che contiene l'interfaccia per cui creare una chiave del Registro di sistema. Il set di informazioni sul dispositivo non deve contenere elementi remoti.
[in] DeviceInterfaceData
Puntatore a una struttura di SP_DEVICE_INTERFACE_DATA che specifica l'interfaccia del dispositivo in DeviceInfoSet. Questo puntatore può essere restituito da SetupDiCreateDeviceInterface.
Reserved
Riservato. Deve essere zero.
[in] samDesired
Accesso di sicurezza del Registro di sistema richiesto dal chiamante per la chiave creata. Per informazioni sui valori di accesso alla sicurezza del Registro di sistema di tipo REGSAM, vedere la documentazione di Microsoft Windows SDK.
[in, optional] InfHandle
Handle di un file INF aperto che contiene una sezione DDInstall da eseguire per la chiave appena creata. Questo parametro è facoltativo e può essere NULL. Se questo parametro non è NULL, è necessario specificare anche InfSectionName.
[in, optional] InfSectionName
Puntatore al nome di una sezione INF
Valore restituito
Se SetupDiCreateDeviceInterfaceRegKey ha esito positivo, la funzione restituisce un handle alla chiave del Registro di sistema richiesta in cui le informazioni sull'interfaccia possono essere archiviate e recuperate. Se SetupDiCreateDeviceInterfaceRegKey ha esito negativo, la funzione restituisce INVALID_HANDLE_VALUE. Chiamare GetLastError per ottenere informazioni estese sull'errore.
Osservazioni
Il chiamante di questa funzione deve essere membro del gruppo Administrators.
Se la chiave richiesta per l'interfaccia del dispositivo esiste già, SetupDiCreateDeviceInterfaceRegKey restituisce un handle a tale chiave; in caso contrario, SetupDiCreateDeviceInterfaceRegKey crea una nuova chiave del Registro di sistema non volatile per l'interfaccia del dispositivo specificata. I chiamanti di questa funzione possono archiviare i dati di configurazione privati per l'interfaccia del dispositivo in questa chiave. Il driver per il dispositivo può accedere a questa chiave usando routine IoXxx.
Chiudere l'handle restituito da questa funzione chiamando RegCloseKey.
Per le installazioni che usano file di layout (specificati dalla voce
Le informazioni sul dispositivo specificate da DeviceInfoSet devono contenere solo elementi nel computer locale.
Nota
L'intestazione setupapi.h definisce SetupDiCreateDeviceInterfaceRegKey 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 |