Compartir a través de

función CM_Get_DevNode_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_DevNode_Property_Keys en su lugar.]

La función CM_Get_DevNode_Property_Keys_Ex recupera una matriz de las claves de propiedad del dispositivo que representan las propiedades del dispositivo que se establecen para una instancia de dispositivo.

Sintaxis

CMAPI CONFIGRET CM_Get_DevNode_Property_Keys_Ex(
  [in]            DEVINST    dnDevInst,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags,
  [in, optional]  HMACHINE   hMachine
);

Parámetros

[in] dnDevInst

Identificador de instancia de dispositivo enlazado al equipo local.

[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 que se establece para la instancia del 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_DevNode_Property_Keys_Ex devuelve el recuento de las claves en *PropertyKeyCount.

[in] ulFlags

Reservado. Debe establecerse en cero.

[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_DevNode_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

SetupDiGetDevicePropertyKeys