Função CM_Get_DevNode_Property_Keys_Ex (cfgmgr32.h)

  • Artigo

[Começando com Windows 8 e Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Get_DevNode_Property_Keys .]

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

Sintaxe

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 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_Ex retornará a contagem das chaves em *PropertyKeyCount.

[in] ulFlags

Reservado. Deve ser definido como zero.

[in, optional] hMachine

Identificador de computador fornecido pelo chamador, obtido de uma chamada anterior para CM_Connect_Machine.

Nota Não há suporte para o uso dessa função para acessar computadores remotos, começando com Windows 8 e Windows Server 2012, pois essa funcionalidade foi removida.
 

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_Ex faz parte do Modelo de Propriedade de Dispositivo Unificado.

Requisitos

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

Confira também

CM_Connect_Machine

SetupDiGetDevicePropertyKeys