IWbemClassObject::Next-Methode (wbemcli.h)
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 |
Weitere Informationen
IWbemClassObject::BeginEnumeration