funzione CM_Get_DevNode_Property_Keys_Ex (cfgmgr32.h)

  • Articolo

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

La funzione CM_Get_DevNode_Property_Keys_Ex recupera una matrice delle chiavi delle proprietà del dispositivo che rappresentano le proprietà del dispositivo impostate per un'istanza del dispositivo.

Sintassi

CMAPI CONFIGRET CM_Get_DevNode_Property_Keys_Ex(
  [in]            DEVINST    dnDevInst,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags,
  [in, optional]  HMACHINE   hMachine
);

Parametri

[in] dnDevInst

Handle dell'istanza del dispositivo associato al computer locale.

[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 l'istanza 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 da contenere tutti i dati della chiave della proprietà, CM_Get_DevNode_Property_Keys_Ex restituisce il conteggio delle chiavi in *PropertyKeyCount.

[in] ulFlags

Riservato. Deve essere impostato su zero.

[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_DevNode_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

SetupDiGetDevicePropertyKeys