función CM_Set_Class_PropertyW (cfgmgr32.h)

  • Artículo

La función CM_Set_Class_Property establece una propiedad de clase para una clase de configuración de dispositivo o una clase de interfaz de dispositivo.

Sintaxis

CMAPI CONFIGRET CM_Set_Class_PropertyW(
  [in] LPCGUID          ClassGUID,
  [in] const DEVPROPKEY *PropertyKey,
  [in] DEVPROPTYPE      PropertyType,
  [in] const PBYTE      PropertyBuffer,
  [in] ULONG            PropertyBufferSize,
  [in] ULONG            ulFlags
);

Parámetros

[in] ClassGUID

Puntero al GUID que identifica la clase de interfaz de dispositivo o la clase de configuración de dispositivo para la que se va a establecer una propiedad de dispositivo. Para obtener información sobre cómo especificar el tipo de clase, vea el parámetro ulFlags .

[in] PropertyKey

Puntero a una estructura DEVPROPKEY que representa la clave de propiedad de la propiedad de clase de dispositivo que se va a establecer.

[in] PropertyType

Valor con tipo DEVPROPTYPE que representa el identificador property-data-type para la propiedad de clase de dispositivo. Para eliminar una propiedad, establézcalo en DEVPROP_TYPE_EMPTY.

[in] PropertyBuffer

Puntero a un búfer que contiene el valor de propiedad de la propiedad de clase de dispositivo. Si se va a eliminar la propiedad o los datos, este puntero debe establecerse en NULL y PropertyBufferSize debe establecerse en cero.

[in] PropertyBufferSize

Tamaño, en bytes, del búfer PropertyBuffer . Si PropertyBuffer está establecido en NULL, PropertyBufferSize debe establecerse en cero.

[in] ulFlags

Marcas de propiedad de clase:

CM_CLASS_PROPERTY_INSTALLER

ClassGUID especifica una clase de configuración de dispositivo. No combine con CM_CLASS_PROPERTY_INTERFACE.

CM_CLASS_PROPERTY_INTERFACE

ClassGUID especifica una clase de interfaz de dispositivo. No combine con CM_CLASS_PROPERTY_INSTALLER.

Valor devuelto

Si la operación se realiza correctamente, la función devuelve CR_SUCCESS. De lo contrario, devuelve uno de los códigos de error con prefijo CR_ definidos en Cfgmgr32.h.

Comentarios

CM_Set_Class_Property forma parte del modelo de propiedades de dispositivo unificado.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Microsoft Windows Vista y versiones posteriores de Windows.
Plataforma de destino Universal
Encabezado cfgmgr32.h (incluya Cfgmgr32.h)
Library Cfgmgr32.lib

Consulte también

SetupDiSetClassProperty