Compartir a través de

función CM_Get_Class_Property_Keys_Ex (cfgmgr32.h)

  • Artículo

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

La función CM_Get_Class_Property_Keys_Ex 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_Ex(
  [in]            LPCGUID    ClassGUID,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [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 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_Ex 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.

[in, optional] hMachine

Identificador de máquina 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 con prefijo CR_ definidos en Cfgmgr32.h.

Comentarios

CM_Get_Class_Property_Keys_Ex forma parte del modelo de propiedades de dispositivo unificado.

Requisitos

Requisito Value
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; OneCoreUAP.lib en Windows 10
Archivo DLL CfgMgr32.dll

Consulte también

CM_Connect_Machine

SetupDiGetClassPropertyKeys

SetupDiGetClassPropertyKeysEx