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 del SDK de Microsoft Windows.
[in, optional] InfHandle
Identificador de un archivo INF abierto que contiene una sección de DDInstall que se va a ejecutar para la clave recién creada. Este parámetro es opcional y se puede NULL. Si este parámetro no se null, también se debe especificar InfSectionName.
[in, optional] InfSectionName
Puntero al nombre de una sección inf
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 de error extendida.
Observaciones
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
Cierre el identificador devuelto de esta función llamando a RegCloseKey.
Para las instalaciones que usan archivos de diseño (especificados por la entrada Layout File en una sección versión inf), el archivo de diseño debe abrirse mediante una llamada a setupOpenAppendInfFile (descrito en la documentación de Windows SDK) antes de se llama a SetupDiCreateDeviceInterfaceReg Key.
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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Microsoft Windows 2000 y versiones posteriores de Windows. |
| de la plataforma de destino de |
Escritorio |
| encabezado de |
setupapi.h (incluya Setupapi.h) |
| biblioteca de |
Setupapi.lib |