Hämta funktion

Hämtar det angivna egenskapsvärdet om det finns.

Anteckning

Det här API:et är endast för internt bruk. Det är inte avsett för användning från utvecklarkod.

Syntax

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

Parametrar

vFunc
[i] Den här parametern används inte.

ptr
[i] En pekare till en IWbemClassObject-instans .

wszName
[i] Namnet på egenskapen.

lFlags
[i] Reserverade. Den här parametern måste vara 0.

pVal
[ut] Om funktionen returnerar korrekt innehåller värdet för wszName egenskapen . Argumentet pval tilldelas rätt typ och värde för kvalificeraren.

pvtType
[ut] Om funktionen returnerar korrekt innehåller en CIM-typ konstant som anger egenskapstypen. Dess värde kan också vara null.

plFlavor
[ut] Om funktionen returnerar korrekt får du information om egenskapens ursprung. Dess värde kan vara null, eller någon av följande WBEM_FLAVOR_TYPE konstanter som definierats i wbemCli.h-huvudfilen :

Konstant	Värde	Beskrivning
WBEM_FLAVOR_ORIGIN_SYSTEM	0x40	Egenskapen är en standardsystemegenskap.
WBEM_FLAVOR_ORIGIN_PROPAGATED	0x20	För en klass: Egenskapen ärvs från den överordnade klassen. För en instans: Egenskapen, även om den ärvts från den överordnade klassen, har inte ändrats av instansen.
WBEM_FLAVOR_ORIGIN_LOCAL	0	För en klass: Egenskapen tillhör den härledda klassen. För en instans: Egenskapen ändras av instansen. det vill: ett värde har angetts eller en kvalificerare har lagts till eller ändrats.

Returvärde

Följande värden som returneras av den här funktionen definieras i wbemCli.h-huvudfilen , eller så kan du definiera dem som konstanter i koden:

Konstant	Värde	Beskrivning
WBEM_E_FAILED	0x80041001	Det har uppstått ett allmänt fel.
WBEM_E_INVALID_PARAMETER	0x80041008	En eller flera parametrar är ogiltiga.
WBEM_E_NOT_FOUND	0x80041002	Den angivna egenskapen hittades inte.
WBEM_E_OUT_OF_MEMORY	0x80041006	Det finns inte tillräckligt med minne för att slutföra åtgärden.
WBEM_S_NO_ERROR	0	Funktionsanropet lyckades.

Kommentarer

Den här funktionen omsluter ett anrop till IWbemClassObject::Get-metoden .

Funktionen Get kan också returnera systemegenskaper.

Argumentet pVal tilldelas rätt typ och värde för kvalificeraren och funktionen COM VariantInit

Krav

Plattformar: Se Systemkrav.

Huvudet: WMINet_Utils.idl

.NET Framework versioner: Tillgänglig sedan 4.7.2

Se även

• WMI- och prestandaräknare (ohanterad API-referens)