QualifierSet_Next functie

Haalt de volgende kwalificatie op in een opsomming die is gestart met een aanroep van de functie QualifierSet_BeginEnumeration .

Notitie

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

Syntaxis

HRESULT QualifierSet_Next (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] BSTR*               pstrName,
   [out] VARIANT*            pVal,
   [out] LONG*               plFlavor
);

Parameters

vFunc [in] Deze parameter is niet gebruikt.

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

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

pstrName [uit] De naam van de kwalificatie. Als null, wordt deze parameter genegeerd; pstrName anders mag niet verwijzen naar een geldige BSTR of een geheugenlek optreedt. Als dit niet null is, wijst de functie altijd een nieuwe BSTR toe wanneer deze retourneert WBEM_S_NO_ERROR.

pVal [uit] Wanneer dit is gelukt, wordt de waarde voor de kwalificatie gebruikt. Als de functie mislukt, wordt de VARIANT aangegeven door pVal niet gewijzigd. Als deze parameter is, wordt nullde parameter genegeerd.

plFlavor [uit] Een verwijzing naar een LONG die de kwalificatiesmaak ontvangt. Als smaakinformatie niet gewenst is, kan deze parameter zijn null.

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_INVALID_PARAMETER	0x80041008	Een parameter is ongeldig.
WBEM_E_UNEXPECTED	0x8004101d	De beller heeft QualifierSet_BeginEnumeration niet aangeroepen.
WBEM_E_OUT_OF_MEMORY	0x80041006	Er is onvoldoende geheugen beschikbaar om een nieuwe opsomming te starten.
WBEM_S_NO_MORE_DATA	0x40005	Er blijven geen kwalificaties meer over in de opsomming.
WBEM_S_NO_ERROR	0	De functie-aanroep is geslaagd.

Opmerkingen

Deze functie verpakt een aanroep naar de methode IWbemQualifierSet::Next .

U roept de QualifierSet_Next functie herhaaldelijk aan om alle kwalificaties op te sommen totdat de functie retourneert WBEM_S_NO_MORE_DATA. Als u de opsomming vroegtijdig wilt beëindigen, roept u de functie QualifierSet_EndEnumeration aan.

De volgorde van de kwalificaties die tijdens de opsomming worden geretourneerd, is niet gedefinieerd.

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)