Functie ophalen

Haalt de opgegeven eigenschapswaarde op als deze bestaat.

Notitie

Deze API is alleen voor intern gebruik. Het is niet bedoeld voor gebruik vanuit code voor ontwikkelaars.

Syntaxis

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

Parameters

vFunc
[in] Deze parameter is niet gebruikt.

ptr
[in] Een verwijzing naar een IWbemClassObject-exemplaar .

wszName
[in] De naam van de eigenschap.

lFlags
[in] Gereserveerd. Deze parameter moet 0 zijn.

pVal
[uit] Als de functie met succes wordt geretourneerd, bevat deze de waarde van de wszName eigenschap. Aan pval het argument wordt het juiste type en de juiste waarde voor de kwalificatie toegewezen.

pvtType
[uit] Als de functie wordt geretourneerd, bevat een constante van het type CIM die het eigenschapstype aangeeft. De waarde kan ook zijn null.

plFlavor
[uit] Als de functie wordt geretourneerd, ontvangt u informatie over de oorsprong van de eigenschap. De waarde kan zijn null, of een van de volgende WBEM_FLAVOR_TYPE constanten die zijn gedefinieerd in het headerbestand WbemCli.h :

Constant	Waarde	Beschrijving
WBEM_FLAVOR_ORIGIN_SYSTEM	0x40	De eigenschap is een standaardsysteemeigenschap.
WBEM_FLAVOR_ORIGIN_PROPAGATED	0x20	Voor een klasse: de eigenschap wordt overgenomen van de bovenliggende klasse. Voor een exemplaar: de eigenschap is overgenomen van de bovenliggende klasse, maar is niet gewijzigd door het exemplaar.
WBEM_FLAVOR_ORIGIN_LOCAL	0	Voor een klasse: de eigenschap behoort tot de afgeleide klasse. Voor een exemplaar: de eigenschap wordt gewijzigd door het exemplaar; dat wil gezegd, er is een waarde opgegeven of er is een kwalificatie toegevoegd of gewijzigd.

Retourwaarde

De volgende waarden die door deze functie worden geretourneerd, worden gedefinieerd in het headerbestand WbemCli.h , of u kunt ze definiëren als constanten in uw code:

Constant	Waarde	Beschrijving
WBEM_E_FAILED	0x80041001	Er is een algemene fout opgetreden.
WBEM_E_INVALID_PARAMETER	0x80041008	Een of meer parameters zijn niet geldig.
WBEM_E_NOT_FOUND	0x80041002	De opgegeven eigenschap is niet gevonden.
WBEM_E_OUT_OF_MEMORY	0x80041006	Er is onvoldoende geheugen beschikbaar om de bewerking te voltooien.
WBEM_S_NO_ERROR	0	De functie-aanroep is geslaagd.

Opmerkingen

Deze functie verpakt een aanroep naar de methode IWbemClassObject::Get .

De Get functie kan ook systeemeigenschappen retourneren.

Aan pVal het argument wordt het juiste type en de juiste waarde toegewezen voor de kwalificatie en de functie COM VariantInit

Vereisten

Platforms: Zie Systeemvereisten.

Header: WMINet_Utils.idl

.NET Framework versies: beschikbaar sinds 4.7.2

Zie ook

• WMI en prestatiemeteritems (niet-beheerde API-verwijzing)