Nästa funktion

Hämtar nästa egenskap i en uppräkning som börjar med ett anrop till BeginEnumeration.

Anteckning

Det här API:et är endast för internt bruk. Det är inte avsett för användning från utvecklarkod.

Syntax

HRESULT Next (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lFlags,
   [out] BSTR*            pstrName,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Parametrar

vFunc
[i] Den här parametern används inte.

ptr
[i] En pekare till en IWbemClassObject-instans .

lFlags
[i] Reserverade. Den här parametern måste vara 0.

pstrName
[ut] En ny BSTR som innehåller egenskapsnamnet. Du kan ange den här parametern till null om namnet inte krävs.

pVal
[ut] En VARIANT fylld med värdet för egenskapen. Du kan ange den här parametern till null om värdet inte krävs. Om funktionen returnerar en felkod lämnas den VARIANT skickade till pVal oförändrad.

pvtType
[ut] En pekare till en CIMTYPE variabel (en LONG som egenskapens typ är placerad i). Värdet för den här egenskapen kan vara en VT_NULL_VARIANT, i vilket fall det är nödvändigt att fastställa den faktiska typen av egenskapen. Den här parametern kan också vara null.

plFlavor
[out] null, eller ett värde som tar emot information om egenskapens ursprung. Se avsnittet [Kommentarer] för möjliga värden.

Returvärde

Följande värden som returneras av den här funktionen definieras i wbemCli.h-huvudfilen , eller så kan du definiera dem som konstanter i koden:

Konstant	Värde	Beskrivning
WBEM_E_FAILED	0x80041001	Det har uppstått ett allmänt fel.
WBEM_E_INVALID_PARAMETER	0x80041008	En parameter är ogiltig.
WBEM_E_UNEXPECTED	0x8004101d	Det fanns inget anrop till BeginEnumeration funktionen.
WBEM_E_OUT_OF_MEMORY	0x80041006	Det finns inte tillräckligt med minne för att påbörja en ny uppräkning.
WBEM_E_TRANSPORT_FAILURE	0x80041015	Fjärrproceduranropet mellan den aktuella processen och Windows Management misslyckades.
WBEM_S_NO_ERROR	0	Funktionsanropet lyckades.
WBEM_S_NO_MORE_DATA	0x40005	Det finns inga fler egenskaper i uppräkningen.

Kommentarer

Den här funktionen omsluter ett anrop till IWbemClassObject::Next-metoden .

Den här metoden returnerar även systemegenskaper.

Om den underliggande typen av egenskapen är en objektsökväg, ett datum eller en tid eller en annan särskild typ innehåller den returnerade typen inte tillräckligt med information. Anroparen måste undersöka CIMTYPE för den angivna egenskapen för att avgöra om egenskapen är en objektreferens, ett datum eller en tid eller en annan särskild typ.

Om plFlavor inte nullLONG får värdet information om egenskapens ursprung enligt följande:

Konstant	Värde	Beskrivning
WBEM_FLAVOR_ORIGIN_SYSTEM	0x40	Egenskapen är en standardsystemegenskap.
WBEM_FLAVOR_ORIGIN_PROPAGATED	0x20	För en klass: Egenskapen ärvs från den överordnade klassen. För en instans: Egenskapen, även om den ärvts från den överordnade klassen, har inte ändrats av instansen.
WBEM_FLAVOR_ORIGIN_LOCAL	0	För en klass: Egenskapen tillhör den härledda klassen. För en instans: Egenskapen ändras av instansen. det vill: ett värde har angetts eller en kvalificerare har lagts till eller ändrats.

Krav

Plattformar: Se Systemkrav.

Huvudet: WMINet_Utils.idl

.NET Framework versioner: Tillgänglig sedan 4.7.2

Se även

• WMI- och prestandaräknare (ohanterad API-referens)