IWbemClassObject::Next-Methode (wbemcli.h)

Artikel
08/27/2023

Die IWbemClassObject::Next-Methode ruft die nächste Eigenschaft in einer Enumeration ab, die mit IWbemClassObject::BeginEnumeration gestartet wurde. Dies sollte wiederholt aufgerufen werden, um alle Eigenschaften aufzulisten, bis WBEM_S_NO_MORE_DATA zurückgibt. Wenn die Enumeration vorzeitig beendet werden soll, sollte IWbemClassObject::EndEnumeration aufgerufen werden.

Die Reihenfolge der während der Enumeration zurückgegebenen Eigenschaften ist nicht definiert.

Syntax

HRESULT Next(
  [in]            long    lFlags,
  [out]           BSTR    *strName,
  [out]           VARIANT *pVal,
  [out, optional] CIMTYPE *pType,
  [out, optional] long    *plFlavor
);

Parameter

[in] lFlags

Reserviert. Dieser Parameter muss 0 sein.

[out] strName

Empfängt einen neuen BSTR , der den Eigenschaftennamen enthält. Um Speicherverluste im Clientprozess zu verhindern, muss der Aufrufer SysFreeString aufrufen, wenn der Name nicht mehr erforderlich ist. Sie können diesen Parameter auf NULL festlegen, wenn der Name nicht erforderlich ist.

[out] pVal

Dieser VARIANT-Wert wird mit dem Wert der -Eigenschaft gefüllt. Die -Methode ruft VariantInit für diesen VARIANT auf, sodass der Aufrufer sicherstellen sollte, dass der VARIANT vor dem Aufruf nicht aktiv ist. Der Aufrufer muss VariantClear verwenden, wenn der Wert nicht mehr erforderlich ist.

Sie können diesen Parameter auf NULL festlegen, wenn der Wert nicht erforderlich ist. Wenn ein Fehlercode zurückgegeben wird, bleibt der VARIANT-Wert , auf den pVal verweist, unverändert.

[out, optional] pType

Dieser Parameter kann NULL sein. Wenn es nicht NULL ist, muss er auf eine CIMTYPE-Variable(long) verweisen, in der der Typ der Eigenschaft platziert wird. Es ist möglich, dass der Wert dieser Eigenschaft ein VT_NULLVARIANT sein kann. In diesem Fall ist es notwendig, den tatsächlichen Typ der Eigenschaft zu bestimmen.

[out, optional] plFlavor

Kann NULL sein. Wenn nicht NULL, empfängt der LONG-Wert , auf den verwiesen wird, Informationen über den Ursprung der Eigenschaft wie folgt. Weitere Informationen finden Sie unter Qualifier Flavors and WBEM_FLAVOR_TYPE.

WBEM_FLAVOR_ORIGIN_SYSTEM

Die Eigenschaft ist eine standardmäßige Systemeigenschaft.

Für Klassen:

WBEM_FLAVOR_ORIGIN_PROPAGATED

Die Eigenschaft wurde von der übergeordneten Klasse geerbt.

Die Eigenschaft wurde zwar von der übergeordneten Klasse geerbt, wurde jedoch auf instance Ebene nicht geändert.

WBEM_FLAVOR_ORIGIN_LOCAL

Die -Eigenschaft gehört zur am meisten abgeleiteten Klasse.

Die -Eigenschaft wird auf der instance-Ebene geändert (das heißt, entweder wurde ein Wert angegeben oder ein Qualifizierer wurde hinzugefügt/geändert).

Für Instanzen:

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. Die folgende Liste listet den Wert auf, der in einem HRESULT enthalten ist. Allgemeine HRESULT-Werte finden Sie unter Systemfehlercodes.

Hinweise

Wenn der zugrunde liegende Typ der Eigenschaft ein Objektpfad, ein Datum oder eine Uhrzeit oder ein anderer spezieller Typ ist, enthält der zurückgegebene Typ nicht genügend Informationen. Der Aufrufer muss CIMTYPE auf die angegebene Eigenschaft untersuchen und ermitteln, ob es sich bei der Eigenschaft um einen Objektverweis, ein Datum oder eine Uhrzeit oder einen anderen besonderen Typ handelt.

Diese Methode gibt auch Systemeigenschaften zurück.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	wbemcli.h (include Wbemidl.h)
Bibliothek	WbemUuid.lib
DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll