Función SetupDiGetClassRegistryPropertyW (setupapi.h)

La función SetupDiGetClassRegistryProperty recupera una propiedad para una clase de instalación de dispositivo especificada del Registro.

Sintaxis

WINSETUPAPI BOOL SetupDiGetClassRegistryPropertyW(
  [in]            const GUID *ClassGuid,
  [in]            DWORD      Property,
  [out, optional] PDWORD     PropertyRegDataType,
  [out]           PBYTE      PropertyBuffer,
  [in]            DWORD      PropertyBufferSize,
  [out, optional] PDWORD     RequiredSize,
  [in, optional]  PCWSTR     MachineName,
                  PVOID      Reserved
);

Parámetros

[in] ClassGuid

Puntero a un GUID que representa la clase de configuración del dispositivo para la que se va a recuperar una propiedad.

[in] Property

Valor que identifica la propiedad que se va a recuperar. Debe ser uno de los siguientes valores:

SPCRP_CHARACTERISTICS

La función devuelve marcas que indican las características del dispositivo para la clase . Para obtener una lista de las marcas de características, consulte el parámetro DeviceCharacteristics para IoCreateDevice.

SPCRP_DEVTYPE

La función devuelve un valor DWORD que representa el tipo de dispositivo de la clase . Para obtener más información, vea Especificar tipos de dispositivo.

SPCRP_EXCLUSIVE

La función devuelve un valor DWORD que indica si los usuarios pueden obtener acceso exclusivo a los dispositivos para esta clase. El valor devuelto es uno si se permite el acceso exclusivo o cero de lo contrario.

SPCRP_LOWERFILTERS

(Windows Vista y versiones posteriores) La función devuelve 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.

SPCRP_SECURITY

La función devuelve el descriptor de seguridad del dispositivo como una estructura de SECURITY_DESCRIPTOR en formato auto relativo (que se describe en la documentación del SDK de Microsoft Windows).

SPCRP_SECURITY_SDS

La función devuelve 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) La función devuelve una REG_MULTI_SZ lista de los nombres de servicio de los controladores de filtro superior instalados para la clase de instalación del dispositivo.

[out, optional] PropertyRegDataType

Puntero a una variable de tipo DWORD que recibe el tipo de datos de propiedad como uno de los tipos de datos del Registro con prefijo REG_. Este parámetro es opcional y se puede NULL. Si este parámetro es null, setupDiGetClassRegistryProperty no devuelve el tipo de datos.

[out] PropertyBuffer

Puntero a un búfer que recibe la propiedad solicitada.

[in] PropertyBufferSize

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

[out, optional] RequiredSize

Puntero a una variable de tipo DWORD que recibe el tamaño necesario, en bytes, del búfer de PropertyBuffer . Si el búfer de PropertyBuffer es demasiado pequeño y RequiredSize no es NULL, la función establece RequiredSize al tamaño mínimo del búfer necesario para recibir la propiedad solicitada.

[in, optional] MachineName

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

Cautela

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 ejecuta correctamente. De lo contrario, devuelve false y el error registrado se puede recuperar con una llamada a GetLastError.

Observaciones

Nota

El encabezado setupapi.h define SetupDiGetClassRegistryProperty 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 Windows XP y versiones posteriores de Windows.
de la plataforma de destino de	DesktopFor universal, call CM_Get_Class_Registry_Property
encabezado de	setupapi.h (incluya Setupapi.h)
biblioteca de	Setupapi.lib

Consulte también

setupDiGetDeviceRegistryProperty

setupDiSetClassRegistryProperty

setupDiSetDeviceRegistryProperty