função CM_Get_Class_Property_ExW (cfgmgr32.h)
[A partir do Windows 8 e do Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Get_Class_Property .]
A função CM_Get_Class_Property_ExW recupera uma propriedade de dispositivo definida para uma classe de interface de dispositivo ou classe de configuração de dispositivo.
Sintaxe
CMAPI CONFIGRET CM_Get_Class_Property_ExW(
[in] LPCGUID ClassGUID,
[in] const DEVPROPKEY *PropertyKey,
[out] DEVPROPTYPE *PropertyType,
[out] PBYTE PropertyBuffer,
[in, out] PULONG PropertyBufferSize,
[in] ULONG ulFlags,
[in] 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 uma propriedade de dispositivo definida para a classe de dispositivo. Para obter informações sobre como especificar o tipo de classe, consulte o parâmetro ulFlags .
[in] PropertyKey
Ponteiro para uma estrutura DEVPROPKEY que representa a chave de propriedade do dispositivo da propriedade de classe de dispositivo solicitada.
[out] PropertyType
Ponteiro para uma variável do tipo DEVPROPTYPE que recebe o identificador property-data-type da propriedade de classe de dispositivo solicitada, em que o identificador de tipo de dados de propriedade é o OR bit a bit entre um identificador de tipo de dados base e, se o tipo de dados base for modificado, um modificador de tipo de dados de propriedade.
[out] PropertyBuffer
Ponteiro para um buffer que recebe a propriedade de classe de dispositivo solicitada. CM_Get_Class_Property_ExW recuperará o valor da propriedade solicitada somente se o buffer for grande o suficiente para manter todos os dados de valor da propriedade. O ponteiro pode ser NULL.
[in, out] PropertyBufferSize
O tamanho, em bytes, do buffer PropertyBuffer . Se o parâmetro PropertyBuffer estiver definido como NULL, *PropertyBufferSize deverá ser definido como zero. Como saída, se o buffer não for grande o suficiente para manter todos os dados de valor da propriedade, CM_Get_Class_Property_ExW retornará o tamanho dos dados, em bytes, em *PropertyBufferSize.
[in] ulFlags
Sinalizadores 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] hMachine
Identificador de computador fornecido pelo chamador, obtido de uma chamada anterior para CM_Connect_Machine.
Valor retornado
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_ExW faz parte do Modelo de Propriedade de Dispositivo Unificado.
Requisitos
| 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 |