Compartir a través de


función CM_Get_Class_Property_Keys (cfgmgr32.h)

La función CM_Get_Class_Property_Keys recupera una matriz de las claves de propiedad del dispositivo que representan las propiedades del dispositivo que se establecen para una clase de interfaz de dispositivo o una clase de configuración de dispositivo.

Sintaxis

CMAPI CONFIGRET CM_Get_Class_Property_Keys(
  [in]            LPCGUID    ClassGUID,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [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 van a recuperar las claves de propiedad. Para obtener información sobre cómo especificar el tipo de clase, vea el parámetro ulFlags .

[out, optional] PropertyKeyArray

Puntero a un búfer que recibe una matriz de valores con tipo DEVPROPKEY, donde cada valor es una clave de propiedad de dispositivo que representa una propiedad de dispositivo establecida para la clase de dispositivo. El puntero es opcional y puede ser NULL.

[in, out] PropertyKeyCount

Tamaño, en unidades con tipo DEVPROPKEY, del búfer PropertyKeyArray . Si PropertyKeyArray se establece en NULL, *PropertyKeyCount debe establecerse en cero. Como salida, si PropertyKeyArray no es lo suficientemente grande como para contener todos los datos de clave de propiedad, CM_Get_Class_Property_Keys devuelve el recuento de las claves, en *PropertyKeyCount.

[in] ulFlags

Marcas de clave 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_Get_Class_Property_Keys 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; OneCoreUAP.lib en Windows 10
Archivo DLL CfgMgr32.dll

Consulte también

SetupDiGetClassPropertyKeys