função CM_Set_DevNode_PropertyW (cfgmgr32.h)

A função CM_Set_DevNode_Property define uma propriedade de instância do dispositivo.

Sintaxe

CMAPI CONFIGRET CM_Set_DevNode_PropertyW(
  [in] DEVINST          dnDevInst,
  [in] const DEVPROPKEY *PropertyKey,
  [in] DEVPROPTYPE      PropertyType,
  [in] const PBYTE      PropertyBuffer,
  [in] ULONG            PropertyBufferSize,
  [in] ULONG            ulFlags
);

Parâmetros

[in] dnDevInst

Identificador de instância do dispositivo associado ao computador local.

[in] PropertyKey

Ponteiro para uma estrutura DEVPROPKEY que representa a chave de propriedade da propriedade da instância do 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 instância do dispositivo. Para excluir uma propriedade, isso deve ser definido como DEVPROP_TYPE_EMPTY.

[in] PropertyBuffer

Ponteiro para um buffer que contém o valor da propriedade da instância do dispositivo. Se a propriedade ou os dados estiverem sendo excluídos, esse ponteiro deverá ser definido como NULL e PropertyBufferSize deverá 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

Reservado. Deve ser definido como zero.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Microsoft Windows Vista e versões posteriores do Windows.
Plataforma de Destino	Universal
Cabeçalho	cfgmgr32.h (inclua Cfgmgr32.h)
Biblioteca	Cfgmgr32.lib

Confira também

SetupDiSetDeviceProperty