Funzione Get

Articolo
05/09/2023

Recupera il valore della proprietà specificato se esiste.

Nota

Questa API è solo per uso interno. Non è destinata all'uso dal codice dello sviluppatore.

Sintassi

HRESULT Get (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LPCWSTR           wszName,
   [in] LONG              lFlags,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Parametri

vFunc
[in] Questo parametro è inutilizzato.

ptr
[in] Puntatore a un'istanza di IWbemClassObject .

wszName
[in] Nome della proprietà.

lFlags
[in] Riservato. Questo parametro deve essere 0.

pVal
[out] Se la funzione restituisce correttamente, contiene il valore della wszName proprietà. L'argomento pval viene assegnato al tipo e al valore corretti per il qualificatore.

pvtType
[out] Se la funzione restituisce correttamente, contiene una costante di tipo CIM che indica il tipo di proprietà. Il valore può anche essere null.

plFlavor
[out] Se la funzione restituisce correttamente, riceve informazioni sull'origine della proprietà. Il valore può essere nullo una delle costanti WBEM_FLAVOR_TYPE seguenti definite nel file di intestazione WbemCli.h :

Costante	Valore	Descrizione
`WBEM_FLAVOR_ORIGIN_SYSTEM`	0x40	La proprietà è una proprietà di sistema standard.
`WBEM_FLAVOR_ORIGIN_PROPAGATED`	0x20	Per una classe: la proprietà viene ereditata dalla classe padre. Per un'istanza: la proprietà, ereditata dalla classe padre, non è stata modificata dall'istanza.
`WBEM_FLAVOR_ORIGIN_LOCAL`	0	Per una classe: la proprietà appartiene alla classe derivata. Per un'istanza: la proprietà viene modificata dall'istanza; ovvero, è stato fornito un valore o è stato aggiunto o modificato un qualificatore.

Valore restituito

I valori seguenti restituiti da questa funzione sono definiti nel file di intestazione WbemCli.h oppure è possibile definirli come costanti nel codice:

Costante	Valore	Descrizione
`WBEM_E_FAILED`	0x80041001	Si è verificato un errore generale.
`WBEM_E_INVALID_PARAMETER`	0x80041008	Uno o più parametri non sono validi.
`WBEM_E_NOT_FOUND`	0x80041002	La proprietà specificata non è stata trovata.
`WBEM_E_OUT_OF_MEMORY`	0x80041006	Memoria insufficiente per completare l’operazione.
`WBEM_S_NO_ERROR`	0	La chiamata alla funzione ha avuto esito positivo.

Commenti

Questa funzione esegue il wrapping di una chiamata al metodo IWbemClassObject::Get .

La Get funzione può anche restituire le proprietà di sistema.

L'argomento pVal viene assegnato il tipo e il valore corretti per il qualificatore e la funzione COM VariantInit

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: WMINet_Utils.idl

Versioni di .NET Framework: Disponibile da 4.7.2

Vedi anche

WMI e contatori delle prestazioni (riferimenti alle API non gestite)

Condividi tramite