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 a 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 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 alla 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 Microsoft Windows SDK.
[in, optional] InfHandle
Handle per 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 DDInstall nel file INF specificato da InfHandle. Questa sezione viene eseguita per la chiave appena creata. Questo parametro è facoltativo e può essere NULL. Se questo parametro è specificato, è necessario specificare anche InfHandle .
Valore restituito
Se SetupDiCreateDeviceInterfaceRegKey riesce, 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 sull'errore estese.
Commenti
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 nonvolatile per l'interfaccia del dispositivo specificata. I chiamanti di questa funzione possono archiviare i dati di configurazione privata per l'interfaccia del dispositivo in questa chiave. Il driver per il dispositivo può accedere a questa chiave usando le routine IoXxx .
Chiudere l'handle restituito da questa funzione chiamando RegCloseKey.
Per le installazioni che usano i file di layout (specificati dalla voce LayoutFile in una sezione INF Version), il file di layout deve essere aperto da una chiamata a SetupOpenAppendInfFile (descritta in Windows SDK documentazione) prima che SetupDiCreateDeviceInterfaceRegKey venga chiamato.
Il set di informazioni sul dispositivo specificato da DeviceInfoSet deve 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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Microsoft Windows 2000 e versioni successive di Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | setupapi.h (includere Setupapi.h) |
| Libreria | Setupapi.lib |