funzione CM_Get_Device_Interface_Property_Keys_ExW (cfgmgr32.h)

Articolo
02/23/2024

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

La funzione CM_Get_Device_Interface_Property_Keys_ExW recupera una matrice di chiavi di proprietà del dispositivo che rappresentano le proprietà del dispositivo impostate per un'interfaccia del dispositivo.

Sintassi

CMAPI CONFIGRET CM_Get_Device_Interface_Property_Keys_ExW(
  [in]            LPCWSTR    pszDeviceInterface,
  [out, optional] DEVPROPKEY *PropertyKeyArray,
  [in, out]       PULONG     PropertyKeyCount,
  [in]            ULONG      ulFlags,
  [in, optional]  HMACHINE   hMachine
);

Parametri

[in] pszDeviceInterface

Puntatore a una stringa che identifica l'istanza dell'interfaccia del dispositivo da cui recuperare le chiavi della proprietà.

[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'interfaccia 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_Device_Interface_Property_Keys_ExW 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_Device_Interface_Property_Keys_ExW 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

Vedi anche

CM_Connect_Machine

SetupDiGetDeviceInterfacePropertyKeys

Condividi tramite