Interfaccia IWbemObjectAccess (wbemcli.h)

Articolo
03/03/2024

L'interfaccia IWbemObjectAccess fornisce l'accesso ai metodi e alle proprietà di un oggetto. Un oggetto IWbemObjectAccess è un contenitore per un'istanza aggiornata da un aggiornamento. Con l'interfaccia IWbemObjectAccess , è possibile ottenere e impostare le proprietà usando handle delle proprietà anziché nomi di proprietà dell'oggetto.

Nota Questa interfaccia non viene implementata da applicazioni client o provider in nessuna circostanza. L'implementazione fornita da WMI è l'unica supportata. È possibile recuperare un puntatore all'interfaccia chiamando IWbemClassObject::QueryInterface.

Ereditarietà

L'interfaccia IWbemObjectAccess eredita dall'interfaccia IUnknown . IWbemObjectAccess include anche questi tipi di membri:

Metodi

L'interfaccia IWbemObjectAccess include questi metodi.


IWbemObjectAccess::GetPropertyHandle Il metodo GetPropertyHandle restituisce un handle univoco che identifica una proprietà. È possibile usare questo handle per identificare le proprietà quando si usano i metodi IWbemObjectAccess per leggere o scrivere i valori delle proprietà.
IWbemObjectAccess::GetPropertyInfoByHandle Il metodo GetPropertyInfoByHandle restituisce il nome e il tipo di dati della proprietà associata a un handle di proprietà.
IWbemObjectAccess::Lock Il metodo Lock impedisce ad altri thread di aggiornare un oggetto IWbemObjectAccess finché non viene sbloccato.
IWbemObjectAccess::ReadDWORD Il metodo ReadDWORD legge 32 bit di dati delle proprietà usando un handle di proprietà.
IWbemObjectAccess::ReadPropertyValue Il metodo ReadPropertyValue restituisce un numero specificato di byte di una proprietà associata a un handle di proprietà.
IWbemObjectAccess::ReadQWORD Il metodo ReadQWORD legge 64 bit di dati delle proprietà identificati da un handle di proprietà.
IWbemObjectAccess::Unlock Il metodo Unlock consente ad altri thread di aggiornare i valori delle proprietà di un oggetto IWbemObjectAccess.
IWbemObjectAccess::WriteDWORD Il metodo WriteDWORD scrive 32 bit di dati in una proprietà identificata da un handle di proprietà.
IWbemObjectAccess::WritePropertyValue Il metodo WritePropertyValue scrive un numero specificato di byte in una proprietà identificata da un handle di proprietà. Usare questo metodo per impostare la stringa e tutti gli altri dati non DWORD o non QWORD.
IWbemObjectAccess::WriteQWORD Il metodo WriteQWORD scrive 64 bit di dati in una proprietà usando un handle di proprietà.

Commenti

I metodi IWbemObjectAccess che leggono e scrivono dati eseguono una convalida dei dati molto piccola. Poiché i metodi IWbemObjectAccess accedono direttamente alle proprietà, è possibile ottenere e impostare proprietà molto più rapidamente di quanto sia possibile usare tecniche di accesso a oggetti standard, ad esempio IWbemClassObject::Get e IWbemClassObject::P ut.

Nota Per ottimizzare la velocità, IWbemObjectAccess è completamente deselezionato. È responsabilità dell'utente assicurarsi che tutti gli handle siano appropriati e che i buffer di scrittura siano ridimensionati correttamente. Le operazioni di lettura e scrittura non sono intrinsecamente thread-safe. È necessario chiamare i metodi IWbemObjectAccess::Lock e IWbemObjectAccess::Unlock per impedire agli oggetti IWbemObjectAccess di accedere simultaneamente in più thread.

Gli handle delle proprietà sono uguali per tutte le istanze di una classe. Pertanto, è necessario recuperare un handle una sola volta.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	wbemcli.h (include Wbemidl.h)

Vedi anche

Accesso ai dati sulle prestazioni in C++

Accesso alle classi di prestazioni preinstallate di WMI

API COM per WMI

IWbemRefresher

Condividi tramite