funzione CM_Get_Class_Property_Keys (cfgmgr32.h)

Articolo
02/26/2024

La funzione CM_Get_Class_Property_Keys recupera una matrice delle chiavi delle proprietà del dispositivo che rappresentano le proprietà del dispositivo impostate per una classe di interfaccia dispositivo o una classe di configurazione del dispositivo.

Sintassi

CMAPI CONFIGRET CM_Get_Class_Property_Keys(
  [in]            LPCGUID    ClassGUID,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags
);

Parametri

[in] ClassGUID

Puntatore al GUID che identifica la classe di interfaccia del dispositivo o la classe di configurazione del dispositivo per cui recuperare le chiavi di proprietà. Per informazioni sulla specifica del tipo di classe, vedere il parametro ulFlags .

[out, optional] PropertyKeyArray

Puntatore a un buffer che riceve una matrice di valori tipizzati DEVPROPKEY, in cui ogni valore è una chiave della proprietà del dispositivo che rappresenta una proprietà del dispositivo impostata per la classe del dispositivo. Il puntatore è facoltativo e può essere NULL.

[in, out] PropertyKeyCount

Dimensioni, in unità tipate DEVPROPKEY, del buffer PropertyKeyArray . Se PropertyKeyArray è impostato su NULL, *PropertyKeyCount deve essere impostato su zero. Come output, se PropertyKeyArray non è sufficientemente grande per contenere tutti i dati della chiave della proprietà, CM_Get_Class_Property_Keys restituisce il conteggio delle chiavi, in *PropertyKeyCount.

[in] ulFlags

Flag di chiave della 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_Keys fa parte del modello di proprietà del 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; OneCoreUAP.lib in Windows 10
DLL	CfgMgr32.dll

Vedi anche

SetupDiGetClassPropertyKeys

Condividi tramite