Következő függvény

Lekéri a következő tulajdonságot egy számbavételben, amely a BeginEnumeration hívással kezdődik.

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 Next (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lFlags,
   [out] BSTR*            pstrName,
   [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ó.

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

pstrName
[kifelé] Egy új BSTR , amely tartalmazza a tulajdonság nevét. Ezt a paramétert beállíthatja arra az esetre, null ha a névre nincs szükség.

pVal
[kifelé] A VARIANT tulajdonság értékével kitöltve. Ezt a paramétert beállíthatja arra az esetre, null ha az értékre nincs szükség. Ha a függvény hibakódot ad vissza, a rendszer nem módosítja az VARIANT átadott pVal értéket.

pvtType
[kifelé] Egy változóra mutató CIMTYPE mutató ( LONG amelybe a tulajdonság típusa kerül). Ennek a tulajdonságnak az értéke lehet egy VT_NULL_VARIANT, ebben az esetben meg kell határozni a tulajdonság tényleges típusát. Ez a paraméter is lehet null.

plFlavor
[out] null, vagy olyan érték, amely információt kap a tulajdonság eredetéről. A lehetséges értékekért tekintse meg a [Megjegyzések] szakaszt.

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	A paraméter érvénytelen.
WBEM_E_UNEXPECTED	0x8004101d	Nem volt hívás a BeginEnumeration függvényre.
WBEM_E_OUT_OF_MEMORY	0x80041006	Nincs elég memória az új számbavétel megkezdéséhez.
WBEM_E_TRANSPORT_FAILURE	0x80041015	Az aktuális folyamat és a Windows Management közötti távoli eljáráshívás sikertelen volt.
WBEM_S_NO_ERROR	0	A függvényhívás sikeres volt.
WBEM_S_NO_MORE_DATA	0x40005	Az enumerálásban nincs több tulajdonság.

Megjegyzések

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

Ez a metódus a rendszertulajdonságokat is visszaadja.

Ha a tulajdonság mögöttes típusa objektumútvonal, dátum vagy idő vagy más speciális típus, akkor a visszaadott típus nem tartalmaz elegendő információt. A hívónak meg kell vizsgálnia a CIMTYPE megadott tulajdonságot annak megállapításához, hogy a tulajdonság objektumhivatkozás, dátum vagy idő vagy más speciális típus-e.

Ha plFlavor nem null, az érték a LONG következőképpen kap információt a tulajdonság eredetéről:

Á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.

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)