função CM_Get_DevNode_Property_Keys (cfgmgr32.h)

  • Artigo

A função CM_Get_DevNode_Property_Keys recupera uma matriz das chaves de propriedade do dispositivo que representam as propriedades do dispositivo definidas para uma instância do dispositivo.

Sintaxe

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

Parâmetros

[in] dnDevInst

Identificador de instância do dispositivo associado ao computador local.

[out, optional] PropertyKeyArray

Ponteiro para um buffer que recebe uma matriz de valores do tipo DEVPROPKEY, em que cada valor é uma chave de propriedade do dispositivo que representa uma propriedade de dispositivo definida para a instância do dispositivo. O ponteiro é opcional e pode ser NULL.

[in, out] PropertyKeyCount

O tamanho, em unidades do tipo DEVPROPKEY, do buffer PropertyKeyArray . Se PropertyKeyArray estiver definido como NULL, *PropertyKeyCount deverá ser definido como zero. Como saída, Se PropertyKeyArray não for grande o suficiente para manter todos os dados da chave de propriedade, CM_Get_DevNode_Property_Keys retornará a contagem das chaves em *PropertyKeyCount.

[in] ulFlags

Reservado. Deve ser definido como zero.

Retornar valor

Se a operação for bem-sucedida, a função retornará CR_SUCCESS. Caso contrário, ele retornará um dos códigos de erro prefixados por CR_ definidos em Cfgmgr32.h.

Comentários

CM_Get_DevNode_Property_Keys faz parte do Modelo de Propriedade de Dispositivo Unificado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Microsoft Windows Vista e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca Cfgmgr32.lib; OneCoreUAP.lib no Windows 10
DLL CfgMgr32.dll

Confira também

SetupDiGetDevicePropertyKeys