funzione CM_Get_DevNode_Property_Keys (cfgmgr32.h)

La funzione CM_Get_DevNode_Property_Keys 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(
  [in]            DEVINST    dnDevInst,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags
);

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 per contenere tutti i dati della chiave della proprietà, CM_Get_DevNode_Property_Keys restituisce il conteggio delle chiavi in *PropertyKeyCount.

[in] ulFlags

Riservato. Deve essere impostato su zero.

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

Requisiti

Vedi anche

SetupDiGetDevicePropertyKeys