funzione CM_Set_Class_Property_ExW (cfgmgr32.h)

Articolo
08/22/2023

[A partire da Windows 8 e Windows Server 2012, questa funzione è stata deprecata. Usare invece CM_Set_Class_Property .]

La funzione CM_Set_Class_Property_ExW imposta una proprietà di classe per una classe di installazione del dispositivo o una classe di interfaccia del dispositivo.

Sintassi

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

Parametri

[in] ClassGUID

Puntatore al GUID che identifica la classe di interfaccia del dispositivo o la classe di installazione del dispositivo per cui impostare una proprietà del dispositivo. Per informazioni sulla specifica del tipo di classe, vedere il parametro ulFlags .

[in] PropertyKey

Puntatore a una struttura DEVPROPKEY che rappresenta la chiave della proprietà della classe del dispositivo da impostare.

[in] PropertyType

Valore tipizzato DEVPROPTYPE che rappresenta l'identificatore property-data-type per la proprietà della classe del dispositivo. Per eliminare una proprietà, impostarla su DEVPROP_TYPE_EMPTY.

[in] PropertyBuffer

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

[in] PropertyBufferSize

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

[in] ulFlags

Flag di proprietà della classe:

CM_CLASS_PROPERTY_INSTALLER

ClassGUID specifica una classe di installazione del dispositivo. Non combinare con CM_CLASS_PROPERTY_INTERFACE.

CM_CLASS_PROPERTY_INTERFACE

ClassGUID specifica una classe di interfaccia del dispositivo. Non combinare con CM_CLASS_PROPERTY_INSTALLER.

[in, optional] hMachine

Handle macchina fornito dal chiamante, ottenuto da una chiamata precedente a CM_Connect_Machine.

Nota L'uso di questa funzione per accedere ai computer remoti non è supportato a partire da Windows 8 e Windows Server 2012, perché questa funzionalità è stata rimossa.

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_Class_Property_ExW fa parte del modello di proprietà unificata del dispositivo.

Requisiti


Client minimo supportato	Disponibile in Microsoft Windows 10 e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	cfgmgr32.h (include Cfgmgr32.h)
Libreria	Cfgmgr32.lib

Vedi anche

CM_Connect_Machine

SetupDiSetClassProperty

Condividi tramite