Függvény lekérése

Lekéri a megadott tulajdonságértéket, ha létezik.

Megjegyzés

Ez az API csak belső használatra készült. Nem fejlesztői kódból való használatra készült.

Szintaxis

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

Paraméterek

vFunc
[in] Ez a paraméter nem használható.

ptr
[in] Egy IWbemClassObject-példányra mutató mutató.

wszName
[in] A tulajdonság neve.

lFlags
[in] Fenntartva. Ennek a paraméternek 0-nak kell lennie.

pVal
[kifelé] Ha a függvény sikeresen visszaadja, a tulajdonság értékét wszName tartalmazza. Az pval argumentum a megfelelő típushoz és értékhez van rendelve a minősítőhöz.

pvtType
[kifelé] Ha a függvény sikeresen visszaadja, a tulajdonságtípust jelző CIM-típusú állandót tartalmaz. Értéke is lehet null.

plFlavor
[kifelé] Ha a függvény sikeresen visszaadja a értéket, információt kap a tulajdonság eredetéről. Értéke a WbemCli.h fejlécfájlban definiált következő WBEM_FLAVOR_TYPE állandók egyike lehetnull:

Állandó	Érték	Leírás
WBEM_FLAVOR_ORIGIN_SYSTEM	0x40	A tulajdonság egy standard rendszertulajdonság.
WBEM_FLAVOR_ORIGIN_PROPAGATED	0x20	Osztály esetén: A tulajdonság a szülőosztálytól öröklődik. Példány esetén: A szülőosztálytól örökölt tulajdonságot a példány nem módosította.
WBEM_FLAVOR_ORIGIN_LOCAL	0	Osztály esetén: A tulajdonság a származtatott osztályhoz tartozik. Példány esetén: A tulajdonságot a példány módosítja; vagyis egy értéket adtak meg, vagy egy minősítőt adtak hozzá vagy módosítottak.

Visszatérési érték

A függvény által visszaadott alábbi értékek a WbemCli.h fejlécfájlban vannak definiálva, vagy konstansként definiálhatók a kódban:

Állandó	Érték	Leírás
WBEM_E_FAILED	0x80041001	Általános hiba történt.
WBEM_E_INVALID_PARAMETER	0x80041008	Egy vagy több paraméter érvénytelen.
WBEM_E_NOT_FOUND	0x80041002	A megadott tulajdonság nem található.
WBEM_E_OUT_OF_MEMORY	0x80041006	Nincs elég memória a művelet végrehajtásához.
WBEM_S_NO_ERROR	0	A függvényhívás sikeres volt.

Megjegyzések

Ez a függvény körbefuttat egy hívást az IWbemClassObject::Get metódushoz.

A Get függvény rendszertulajdonságokat is visszaadhat.

Az pVal argumentum a minősítő és a COM VariantInit függvény megfelelő típusához és értékéhez van hozzárendelve

Követelmények

Platformok: Lásd: Rendszerkövetelmények.

Fejléc: WMINet_Utils.idl

.NET-keretrendszer verziók: 4.7.2-től érhető el

Lásd még

• WMI- és teljesítményszámlálók (nem felügyelt API-referencia)