Função CM_Set_Class_Property_ExW (cfgmgr32.h)

  • Artigo

[A partir do Windows 8 e do Windows Server 2012, essa função foi preterida. Em vez disso, use CM_Set_Class_Property .]

A função CM_Set_Class_Property_ExW define uma propriedade de classe para uma classe de configuração de dispositivo ou uma classe de interface do dispositivo.

Sintaxe

CMAPI CONFIGRET CM_Set_Class_Property_ExW(
  [in]           LPCGUID          ClassGUID,
  [in]           const DEVPROPKEY *PropertyKey,
  [in]           DEVPROPTYPE      PropertyType,
  [in]           const PBYTE      PropertyBuffer,
  [in]           ULONG            PropertyBufferSize,
  [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 definir uma propriedade 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 da propriedade da classe de dispositivo a ser definida.

[in] PropertyType

Um valor do tipo DEVPROPTYPE que representa o identificador de tipo de dados de propriedade para a propriedade da classe de dispositivo. Para excluir uma propriedade, defina-a como DEVPROP_TYPE_EMPTY.

[in] PropertyBuffer

Ponteiro para um buffer que contém o valor da propriedade da classe de dispositivo. Se a propriedade ou os dados devem ser excluídos, esse ponteiro deve ser definido como NULL e PropertyBufferSize deve ser definido como zero.

[in] PropertyBufferSize

O tamanho, em bytes, do buffer PropertyBuffer . Se PropertyBuffer estiver definido como NULL, PropertyBufferSize deverá ser definido como zero.

[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, 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 a partir do Windows 8 e do Windows Server 2012, pois essa funcionalidade foi removida.
 

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

Confira também

CM_Connect_Machine

SetupDiSetClassProperty