funzione CM_Get_Class_PropertyW (cfgmgr32.h)
La funzione CM_Get_Class_Property recupera una proprietà del dispositivo impostata per una classe di interfaccia dispositivo o una classe di installazione del dispositivo.
Sintassi
CMAPI CONFIGRET CM_Get_Class_PropertyW(
[in] LPCGUID ClassGUID,
[in] const DEVPROPKEY *PropertyKey,
[out] DEVPROPTYPE *PropertyType,
[out] PBYTE PropertyBuffer,
[in, out] PULONG PropertyBufferSize,
[in] ULONG ulFlags
);
Parametri
[in] ClassGUID
Puntatore al GUID che identifica la classe di configurazione dell'interfacciadel dispositivo o la classe di installazione 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à del dispositivo della proprietà della classe di 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 di tipo property-data-type.
[out] PropertyBuffer
Puntatore a un buffer che riceve la proprietà della classe di dispositivo richiesta. CM_Get_Class_Property recupera il valore della proprietà richiesto solo se il buffer è abbastanza grande per contenere tutti i dati del valore della proprietà. Il puntatore può essere NULL.
[in, out] PropertyBufferSize
Dimensioni, in byte, del buffer PropertyBuffer . Se il parametro PropertyBuffer è impostato su NULL, *PropertyBufferSize deve essere impostato su zero. Come output, se il buffer non è abbastanza grande per contenere tutti i dati del valore della proprietà, CM_Get_Class_Property restituisce le dimensioni dei dati, in byte, in *PropertyBufferSize.
[in] ulFlags
Flag delle proprietà di 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.
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 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 |