Función SetupDiSetClassRegistryPropertyA (setupapi.h)

La función SetupDiSetClassRegistryProperty establece una propiedad de clase de dispositivo especificada en el Registro.

Sintaxis

WINSETUPAPI BOOL SetupDiSetClassRegistryPropertyA(
  [in]           const GUID *ClassGuid,
  [in]           DWORD      Property,
  [in, optional] const BYTE *PropertyBuffer,
  [in]           DWORD      PropertyBufferSize,
  [in, optional] PCSTR      MachineName,
                 PVOID      Reserved
);

Parámetros

[in] ClassGuid

Puntero al GUID que identifica la clase de dispositivo para la que se va a establecer una propiedad.

[in] Property

Valor que identifica la propiedad que se va a establecer, que debe ser una de las siguientes:

SPCRP_CHARACTERISTICS

El autor de la llamada proporciona marcas que especifican las características del dispositivo para la clase . Para obtener una lista de las marcas de características, consulte el parámetro DeviceCharacteristics de IoCreateDevice. Las características del dispositivo deben establecerse cuando se instala la clase de dispositivo y no deben cambiarse después de instalar la clase de dispositivo.

SPCRP_DEVTYPE

El autor de la llamada proporciona el tipo de dispositivo para la clase . Para obtener más información, vea Especificar tipos de dispositivo. El tipo de dispositivo debe establecerse cuando se instala una clase de dispositivo y no debe cambiarse después de instalar la clase de dispositivo.

SPCRP_EXCLUSIVE

El autor de la llamada proporciona un valor DWORD que especifica si los usuarios pueden obtener acceso exclusivo a los dispositivos para esta clase. El valor proporcionado es 1 si se permite el acceso exclusivo o cero de lo contrario. La configuración exclusiva de un dispositivo debe establecerse cuando se instala una clase de dispositivo y no debe cambiarse después de instalar la clase de dispositivo.

SPCRP_LOWERFILTERS

(Windows Vista y versiones posteriores) El autor de la llamada proporciona una lista REG_MULTI_SZ de los nombres de servicio de los controladores de filtro inferiores que se instalan para la clase de configuración del dispositivo. Para obtener más información sobre cómo instalar un controlador de filtro de clase, vea Instalación de un controlador de filtro y la sección INF ClassInstall32.

SPCRP_SECURITY

El autor de la llamada proporciona el descriptor de seguridad del dispositivo como una estructura de SECURITY_DESCRIPTOR en formato relativo propio (que se describe en la documentación de Microsoft Windows SDK).

SPCRP_SECURITY_SDS

El autor de la llamada proporciona el descriptor de seguridad del dispositivo como una cadena de texto. Para obtener información sobre las cadenas de descriptores de seguridad, vea Security Descriptor Definition Language (Windows). Para obtener información sobre el formato de las cadenas de descriptor de seguridad, vea Security Descriptor Definition Language (Windows).

SPCRP_UPPERFILTERS

(Windows Vista y versiones posteriores) El autor de la llamada proporciona una lista REG_MULTI_SZ de los nombres de servicio de los controladores de filtro superior instalados para la clase de configuración del dispositivo. Para obtener más información sobre cómo instalar un controlador de filtro de clase, vea Instalación de un controlador de filtro y la sección INF ClassInstall32.

[in, optional] PropertyBuffer

Puntero a un búfer que proporciona la propiedad especificada. Este parámetro es opcional y puede ser NULL.

[in] PropertyBufferSize

Tamaño, en bytes, del búfer PropertyBuffer .

[in, optional] MachineName

Puntero a una cadena terminada en NULL que contiene el nombre de un sistema remoto en el que se va a establecer la propiedad de clase de dispositivo especificada. Este parámetro es opcional y puede ser NULL. Si este parámetro es NULL, la propiedad se establece en el nombre del sistema local.

Precaución

No se admite el uso de esta función para acceder a máquinas remotas a partir de Windows 8 y Windows Server 2012, ya que esta funcionalidad se ha quitado.

Reserved

Reservado, debe ser NULL.

Valor devuelto

La función devuelve TRUE si se realiza correctamente. De lo contrario, devuelve FALSE y el error registrado se puede recuperar con una llamada a GetLastError.

Comentarios

El autor de la llamada de esta función debe ser miembro del grupo Administradores.

Para determinar el tipo de datos de una propiedad de clase de dispositivo, llame a SetupDiGetClassRegistryProperty.

Nota

El encabezado setupapi.h define SetupDiSetClassRegistryProperty 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 Windows XP y versiones posteriores de Windows.
Plataforma de destino Escritorio
Encabezado setupapi.h (incluya Setupapi.h)
Library Setupapi.lib

Consulte también

SetupDiGetClassRegistryProperty

SetupDiGetDeviceRegistryProperty

SetupDiSetDeviceRegistryProperty