Compartir a través de

función CM_Set_Class_Property_ExW (cfgmgr32.h)

  • Artículo

[A partir de Windows 8 y Windows Server 2012, esta función ha quedado en desuso. Use CM_Set_Class_Property en su lugar.]

La función CM_Set_Class_Property_ExW 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_Property_ExW(
  [in]           LPCGUID          ClassGUID,
  [in]           const DEVPROPKEY *PropertyKey,
  [in]           DEVPROPTYPE      PropertyType,
  [in]           const PBYTE      PropertyBuffer,
  [in]           ULONG            PropertyBufferSize,
  [in]           ULONG            ulFlags,
  [in, optional] HMACHINE         hMachine
);

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 la 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 se establece 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 se combine con CM_CLASS_PROPERTY_INTERFACE.

CM_CLASS_PROPERTY_INTERFACE

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

[in, optional] hMachine

Identificador de equipo proporcionado por el autor de la llamada, obtenido de una llamada anterior a CM_Connect_Machine.

Nota 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.
 

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 CR_ prefijo definidos en Cfgmgr32.h.

Comentarios

CM_Set_Class_Property_ExW forma parte del modelo de propiedades de dispositivo unificado.

Requisitos

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

Consulte también

CM_Connect_Machine

SetupDiSetClassProperty