Next-Funktion

Artikel
06/05/2023

Hiermit wird die nächste Eigenschaft in einer Enumeration abgerufen, die mit einem Aufruf von BeginEnumeration startet.

Hinweis

Diese API ist ausschließlich für die interne Verwendung vorgesehen. Sie ist nicht für die Verwendung im Entwicklercode vorgesehen.

Syntax

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

Parameter

vFunc
[in] Dieser Parameter wird nicht verwendet.

ptr
[in] Dies ist ein Zeiger auf eine IWbemClassObject-Instanz.

lFlags
[in]: Reserviert Dieser Parameter muss 0 entsprechen.

pstrName
[out] Dies ist ein neues BSTR-Element, das den Eigenschaftennamen enthält. Sie können diesen Parameter auf null festlegen, wenn der Name nicht erforderlich ist.

pVal
[out] Dies ist ein VARIANT-Element, das mit dem Wert der Eigenschaft aufgefüllt wird. Sie können diesen Parameter auf null festlegen, wenn der Wert nicht erforderlich ist. Wenn die Funktion einen Fehlercode zurückgibt, bleibt das an pVal übergebene VARIANT-Element unverändert.

pvtType
[out] Dies ist ein Zeiger auf eine CIMTYPE-Variable (LONG-Element, in dem der Typ der Eigenschaft platziert wird). Der Wert dieser Eigenschaft kann ein VT_NULL_VARIANT-Element sein. In diesem Fall ist es erforderlich, den tatsächlichen Typ der Eigenschaft zu bestimmen. Dieser Parameter kann auch null sein.

plFlavor
[out] Dieser Parameter entspricht null oder einem Wert, der Informationen zum Ursprung der Eigenschaft empfängt. Mögliche Werte finden Sie im Abschnitt [Hinweise].

Rückgabewert

Die folgenden von dieser Funktion zurückgegebenen Werte werden in der WbemCli.h-Headerdatei definiert, oder Sie können sie als Konstanten im Code definieren:

Konstante	Wert	BESCHREIBUNG
`WBEM_E_FAILED`	0x80041001	Ein allgemeiner Fehler ist aufgetreten.
`WBEM_E_INVALID_PARAMETER`	0x80041008	Ein Parameter ist ungültig.
`WBEM_E_UNEXPECTED`	0x8004101d	Die `BeginEnumeration`-Funktion wurde nicht aufgerufen.
`WBEM_E_OUT_OF_MEMORY`	0x80041006	Es ist nicht genügend Arbeitsspeicher verfügbar, um eine neue Enumeration zu starten.
`WBEM_E_TRANSPORT_FAILURE`	0x80041015	Beim Remoteprozeduraufruf zwischen dem aktuellen Prozess und der Windows-Verwaltung ist ein Fehler aufgetreten.
`WBEM_S_NO_ERROR`	0	Der Funktionsaufruf war erfolgreich.
`WBEM_S_NO_MORE_DATA`	0x40005	In der Enumeration sind keine weiteren Eigenschaften vorhanden.

Bemerkungen

Diese Funktion umschließt einen Aufruf der IWbemClassObject::Next-Methode.

Diese Methode gibt auch Systemeigenschaften zurück.

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

Wenn plFlavor nicht null entspricht, empfängt der LONG-Wert Informationen zum Ursprung der Eigenschaft:

Konstante	Wert	BESCHREIBUNG
`WBEM_FLAVOR_ORIGIN_SYSTEM`	0x40	Die Eigenschaft ist eine Standardsystemeigenschaft.
`WBEM_FLAVOR_ORIGIN_PROPAGATED`	0x20	Für eine Klasse: Die Eigenschaft wird von der übergeordneten Klasse geerbt. Für eine Instanz: Die Eigenschaft, die von der übergeordneten Klasse geerbt wurde, wurde von der Instanz nicht geändert.
`WBEM_FLAVOR_ORIGIN_LOCAL`	0	Für eine Klasse: Die Eigenschaft gehört zur abgeleiteten Klasse. Für eine Instanz: Die Eigenschaft wird von der Instanz geändert. Dies bedeutet, dass ein Wert angegeben oder ein Qualifizierer hinzugefügt oder geändert wurde.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

.NET Framework-Versionen: Verfügbar seit Version 4.7.2

Siehe auch

WMI und Leistungsindikatoren (Referenz zur nicht verwalteten API)

Freigeben über