Función SetupDiCreateDeviceInterfaceRegKeyA (setupapi.h)
La función SetupDiCreateDeviceInterfaceRegKey crea una clave del Registro para almacenar información sobre una interfaz de dispositivo y devuelve un identificador a la clave.
Sintaxis
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
);
Parámetros
[in] DeviceInfoSet
Identificador de un conjunto de información de dispositivo que contiene la interfaz para la que se va a crear una clave del Registro. El conjunto de información del dispositivo no debe contener elementos remotos.
[in] DeviceInterfaceData
Puntero a una estructura de SP_DEVICE_INTERFACE_DATA que especifica la interfaz del dispositivo en DeviceInfoSet. Este puntero es posiblemente devuelto por SetupDiCreateDeviceInterface.
Reserved
Reservado. Debe ser cero.
[in] samDesired
Acceso de seguridad del Registro que el autor de la llamada solicita para la clave que se está creando. Para obtener información sobre los valores de acceso de seguridad del Registro de tipo REGSAM, consulte la documentación de Microsoft Windows SDK.
[in, optional] InfHandle
Identificador de un archivo INF abierto que contiene una sección DDInstall que se va a ejecutar para la clave recién creada. Este parámetro es opcional y puede ser NULL. Si este parámetro no es NULL, también se debe especificar InfSectionName .
[in, optional] InfSectionName
Puntero al nombre de una sección INF DDInstall del archivo INF especificado por InfHandle. Esta sección se ejecuta para la clave recién creada. Este parámetro es opcional y puede ser NULL. Si se especifica este parámetro, también se debe especificar InfHandle .
Valor devuelto
Si SetupDiCreateDeviceInterfaceRegKey se realiza correctamente, la función devuelve un identificador a la clave del Registro solicitada en la que se puede almacenar y recuperar la información de la interfaz. Si se produce un error en SetupDiCreateDeviceInterfaceRegKey , la función devuelve INVALID_HANDLE_VALUE. Llame a GetLastError para obtener información extendida sobre el error.
Comentarios
El autor de la llamada de esta función debe ser miembro del grupo Administradores.
Si la clave solicitada para la interfaz del dispositivo ya existe, SetupDiCreateDeviceInterfaceRegKey devuelve un identificador a esa clave; De lo contrario, SetupDiCreateDeviceInterfaceRegKey crea una nueva clave del Registro no volátil para la interfaz de dispositivo especificada. Los autores de llamadas de esta función pueden almacenar datos de configuración privados para la interfaz del dispositivo en esta clave. El controlador del dispositivo puede acceder a esta clave mediante rutinas de IoXxx .
Cierre el identificador devuelto de esta función mediante una llamada a RegCloseKey.
En el caso de las instalaciones que usan archivos de diseño (especificados por la entrada LayoutFile en una sección Versión inf), el archivo de diseño debe abrirse mediante una llamada a SetupOpenAppendInfFile (que se describe en Windows SDK documentación) antes de llamar a SetupDiCreateDeviceInterfaceRegKey.
La información del dispositivo especificada por DeviceInfoSet solo debe contener elementos en el equipo local.
Nota
El encabezado setupapi.h define SetupDiCreateDeviceInterfaceRegKey como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | setupapi.h (incluya Setupapi.h) |
| Library | Setupapi.lib |