funzione CM_Set_DevNode_PropertyW (cfgmgr32.h)

Articolo
02/28/2024

La funzione CM_Set_DevNode_Property imposta una proprietà dell'istanza del dispositivo.

Sintassi

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
);

Parametri

[in] dnDevInst

Handle dell'istanza del dispositivo associato al computer locale.

[in] PropertyKey

Puntatore a una struttura DEVPROPKEY che rappresenta la chiave di proprietà della proprietà dell'istanza del dispositivo da impostare.

[in] PropertyType

Valore tipizzato DEVPROPTYPE che rappresenta l'identificatore property-data-type per la proprietà dell'istanza del dispositivo. Per eliminare una proprietà, è necessario impostare su DEVPROP_TYPE_EMPTY.

[in] PropertyBuffer

Puntatore a un buffer contenente il valore della proprietà dell'istanza del dispositivo. Se la proprietà o i dati vengono eliminati, questo puntatore deve essere impostato su NULL e PropertyBufferSize deve essere impostato su zero.

[in] PropertyBufferSize

Dimensioni, in byte, del buffer PropertyBuffer . Se PropertyBuffer è impostato su NULL, PropertyBufferSize deve essere impostato su zero.

[in] ulFlags

Riservato. Deve essere impostato su zero.

Valore restituito

Se l'operazione ha esito positivo, la funzione restituisce CR_SUCCESS. In caso contrario, restituisce uno dei codici di errore con prefisso CR_ definiti in Cfgmgr32.h.

Commenti

CM_Set_DevNode_Property fa parte del modello di proprietà dispositivo unificato.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Microsoft Windows Vista e versioni successive di Windows.
Piattaforma di destinazione	Universale
Intestazione	cfgmgr32.h (include Cfgmgr32.h)
Libreria	Cfgmgr32.lib

Vedi anche

SetupDiSetDeviceProperty

Condividi tramite