função CM_Get_Class_Property_Keys (cfgmgr32.h)

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

Sintaxe

CMAPI CONFIGRET CM_Get_Class_Property_Keys(
  [in]            LPCGUID    ClassGUID,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags
);

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 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.

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

Requisitos

Confira também

SetupDiGetClassPropertyKeys