funzione CM_Get_DevNode_Property_ExW (cfgmgr32.h)

Articolo
03/08/2023

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

La funzione CM_Get_DevNode_Property_ExW recupera una proprietà dell'istanza del dispositivo.

Sintassi

CMAPI CONFIGRET CM_Get_DevNode_Property_ExW(
  [in]           DEVINST          dnDevInst,
  [in]           const DEVPROPKEY *PropertyKey,
  [out]          DEVPROPTYPE      *PropertyType,
  [out]          PBYTE            PropertyBuffer,
  [in, out]      PULONG           PropertyBufferSize,
  [in]           ULONG            ulFlags,
  [in, optional] HMACHINE         hMachine
);

Parametri

[in] dnDevInst

Handle dell'istanza del dispositivo associato al computer locale.

[in] PropertyKey

Puntatore a una struttura DEVPROPKEY che rappresenta la chiave della proprietà della proprietà dell'istanza del dispositivo richiesta.

[out] PropertyType

Puntatore a una variabile tipizzata DEVPROPTYPE che riceve l'identificatore property-data-type della proprietà dell'istanza del dispositivo richiesta, in cui l'identificatore property-data-type è l'OR bit per bit tra un identificatore di tipo dati di base e, se il tipo di dati di base viene modificato, un modificatore property-data-type.

[out] PropertyBuffer

Puntatore a un buffer che riceve la proprietà dell'istanza del dispositivo richiesta. CM_Get_DevNode_Property_ExW recupera la proprietà richiesta solo se il buffer è sufficientemente grande da contenere tutti i dati del valore della proprietà. Il puntatore può essere NULL.

[in, out] PropertyBufferSize

Dimensione, in byte, del buffer PropertyBuffer . Se PropertyBuffer è impostato su NULL, *PropertyBufferSize deve essere impostato su zero. Come output, se il buffer non è sufficientemente grande da contenere tutti i dati del valore della proprietà, CM_Get_DevNode_Property_ExW restituisce le dimensioni dei dati, in byte, in *PropertyBufferSize.

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

Requisiti


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

SetupDiGetDeviceProperty

Condividi tramite