Funzione SetupDiCreateDeviceInterfaceRegKeyW (setupapi.h)

Articolo
11/20/2024

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 SetupDiCreateDeviceInterfaceRegKeyW(
  [in]           HDEVINFO                  DeviceInfoSet,
  [in]           PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
                 DWORD                     Reserved,
  [in]           REGSAM                    samDesired,
  [in, optional] HINF                      InfHandle,
  [in, optional] PCWSTR                    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 DDInstall nel file INF specificato da InfHandle. Questa sezione viene eseguita per la chiave appena creata. Questo parametro è facoltativo e può essere NULL. Se si specifica questo parametro, è necessario specificare anche InfHandle.

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 LayoutFilesezione VERSIONE INF), il file di layout deve essere aperto da una chiamata a SetupOpenAppendInfFile (descritto nella documentazione di Windows SDK) prima di chiamare SetupDiCreateDeviceInterfaceRegKey.

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

Vedere anche

SetupDiCreateDeviceInterface

SetupDiDeleteDeviceInterfaceRegKey

SetupDiOpenDeviceInterfaceRegKey

Condividi tramite