funzione CM_Get_Class_Property_ExW (cfgmgr32.h)

Articolo
03/08/2023

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

La funzione CM_Get_Class_Property_ExW recupera una proprietà del dispositivo impostata per una classe di interfaccia dispositivo o una classe di configurazione del dispositivo.

Sintassi

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

Parametri

[in] ClassGUID

Puntatore al GUID che identifica la classe di interfaccia del dispositivo o la classe di configurazione del dispositivo per cui recuperare una proprietà del dispositivo impostata per la classe 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 richiesta.

[out] PropertyType

Puntatore a una variabile tipizzata DEVPROPTYPE che riceve l'identificatore property-data-type della proprietà della classe di dispositivo richiesta, in cui l'identificatore property-data-type è l'identificatore OR bit per bit tra un identificatore di tipo dati di base e, se il tipo di dati di base viene modificato, un modificatore property-data-type.

[out] PropertyBuffer

Puntatore a un buffer che riceve la proprietà della classe del dispositivo richiesta. CM_Get_Class_Property_ExW recupera il valore della proprietà richiesto solo se il buffer è sufficientemente grande da contenere tutti i dati del valore della proprietà. Il puntatore può essere NULL.

[in, out] PropertyBufferSize

Dimensione, in byte, del buffer PropertyBuffer . Se il parametro PropertyBuffer è impostato su NULL, *PropertyBufferSize deve essere impostato su zero. Come output, se il buffer non è sufficientemente grande da contenere tutti i dati del valore della proprietà, CM_Get_Class_Property_ExW restituisce le dimensioni dei dati, in byte, in *PropertyBufferSize.

[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] 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_Get_Class_Property_ExW fa parte del modello di proprietà del dispositivo unificato.

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

SetupDiGetClassProperty

SetupDiGetClassPropertyEx