Compartir a través de

función CM_Set_Class_Registry_PropertyA (cfgmgr32.h)

  • Artículo

La función CM_Set_Class_Registry_Property establece o elimina una propiedad de una clase de configuración de dispositivo.

Sintaxis

CMAPI CONFIGRET CM_Set_Class_Registry_PropertyA(
  [in]           LPGUID   ClassGuid,
  [in]           ULONG    ulProperty,
  [in, optional] PCVOID   Buffer,
  [in]           ULONG    ulLength,
  [in]           ULONG    ulFlags,
  [in, optional] HMACHINE hMachine
);

Parámetros

[in] ClassGuid

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

[in] ulProperty

Valor de tipo ULONG que identifica la propiedad que se va a establecer. Este valor debe ser uno de los valores CM_CRP_Xxx que se describen para el parámetro ulProperty de la función CM_Get_Class_Registry_Property .

[in, optional] Buffer

Puntero a un búfer que contiene los datos de propiedad. Este parámetro es opcional y se puede establecer en NULL. Para obtener más información sobre cómo establecer este parámetro y el parámetro ulLength correspondiente, vea la siguiente sección Comentarios .

[in] ulLength

Valor de tipo ULONG que especifica el tamaño, en bytes, de los datos de propiedad.

[in] ulFlags

Reservado para uso interno. Debe establecerse en cero.

[in, optional] hMachine

Identificador de una máquina remota en la que se va a establecer la propiedad de clase de configuración de dispositivo especificada. Este parámetro es opcional. Si se establece en NULL, la propiedad se establece en el equipo local.

Valor devuelto

Si la operación se realiza correctamente, CM_Set_Class_Registry_Property devuelve CR_SUCCESS. De lo contrario, la función devuelve uno de los otros códigos de estado CR_Xxx definidos en Cfgmgr32.h.

Comentarios

Si Buffer es NULL, ulLength debe establecerse en cero.

Si ulLength se establece en cero, la función elimina la propiedad .

Si Buffer no se establece en NULL y ulLength no se establece en cero, el valor proporcionado debe ser el tamaño correcto para el tipo de datos REG_Xxx para la propiedad especificada en ulProperty.

Requisitos

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

Consulte también

CM_Get_Class_Registry_Property
SetupDiGetClassRegistryProperty
SetupDiSetClassRegistryProperty