Función SetupDiCreateDeviceInterfaceRegKeyW (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 SetupDiCreateDeviceInterfaceRegKeyW(
  [in]           HDEVINFO                  DeviceInfoSet,
  [in]           PSP_DEVICE_INTERFACE_DATA DeviceInterfaceData,
                 DWORD                     Reserved,
  [in]           REGSAM                    samDesired,
  [in, optional] HINF                      InfHandle,
  [in, optional] PCWSTR                    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

Consulte también

SetupDiCreateDeviceInterface

SetupDiDeleteDeviceInterfaceRegKey

SetupDiOpenDeviceInterfaceRegKey