funzione CM_Get_Class_Property_Keys_Ex (cfgmgr32.h)

  • Articolo

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

La funzione CM_Get_Class_Property_Keys_Ex 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_Ex(
  [in]            LPCGUID    ClassGUID,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [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 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_Ex 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.

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

Requisiti

Requisito Valore
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; OneCoreUAP.lib in Windows 10
DLL CfgMgr32.dll

Vedi anche

CM_Connect_Machine

SetupDiGetClassPropertyKeys

SetupDiGetClassPropertyKeysEx