Função CM_Get_Class_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_Class_Property_Keys .]

A função CM_Get_Class_Property_Keys_Ex recupera uma matriz das chaves de propriedade do dispositivo que representam as propriedades do dispositivo definidas para uma classe de interface de dispositivo ou classe de configuração de dispositivo.

Sintaxe

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

Ponteiro para o GUID que identifica a classe de interface do dispositivo ou a classe de configuração do dispositivo para a qual recuperar as chaves de propriedade. Para obter informações sobre como especificar o tipo de classe, consulte o parâmetro ulFlags .

[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 classe de 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_Class_Property_Keys_Ex retornará a contagem das chaves, em *PropertyKeyCount.

[in] ulFlags

Sinalizadores de chave de propriedade de classe:

CM_CLASS_PROPERTY_INSTALLER

ClassGUID especifica uma classe de configuração de dispositivo. Não combine com CM_CLASS_PROPERTY_INTERFACE.

CM_CLASS_PROPERTY_INTERFACE

ClassGUID especifica uma classe de interface do dispositivo. Não combine com CM_CLASS_PROPERTY_INSTALLER.

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

SetupDiGetClassPropertyKeys

SetupDiGetClassPropertyKeysEx