QualifierSet_Next függvény

Lekéri a következő minősítőt egy számbavételben, amely a QualifierSet_BeginEnumeration függvény hívásával kezdődött.

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 QualifierSet_Next (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] BSTR*               pstrName,
   [out] VARIANT*            pVal,
   [out] LONG*               plFlavor
);

Paraméterek

vFunc [in] Ez a paraméter nincs használatban.

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

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

pstrName [kifelé] A minősítő neve. Ha nulla paramétert a rendszer figyelmen kívül hagyja, ellenkező esetben nem szabad érvényesre BSTR mutatnia, pstrName vagy memóriavesztés történik. Ha nem null, a függvény mindig újat BSTR foglal le a visszaadásakor WBEM_S_NO_ERROR.

pVal [kifelé] Ha sikeres, a minősítő értéke. Ha a függvény meghibásodik, a VARIANT rá mutatás pVal nem módosul. Ha ez a nullparaméter , a paraméter figyelmen kívül lesz hagyva.

plFlavor [kifelé] Egy hosszú mutató, amely a minősítő ízt kapja. Ha az ízadatok nem kívánatosak, ez a paraméter lehet null.

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_INVALID_PARAMETER	0x80041008	Érvénytelen paraméter.
WBEM_E_UNEXPECTED	0x8004101d	A hívó nem hívta QualifierSet_BeginEnumeration.
WBEM_E_OUT_OF_MEMORY	0x80041006	Nincs elég memória az új számbavétel megkezdéséhez.
WBEM_S_NO_MORE_DATA	0x40005	Az enumerálásban nem marad több minősítő.
WBEM_S_NO_ERROR	0	A függvényhívás sikeres volt.

Megjegyzések

Ez a függvény az IWbemQualifierSet::Next metódus hívását burkolja.

A függvényt többször is meghívja QualifierSet_Next az összes minősítő számbavételéhez, amíg a függvény vissza nem adja WBEM_S_NO_MORE_DATAa értéket. Az enumerálás korai leállításához hívja meg a QualifierSet_EndEnumeration függvényt.

Az enumerálás során visszaadott minősítők sorrendje nincs meghatározva.

Követelmények

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

Fejléc: WMINet_Utils.idl

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

Lásd még

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