Next-Funktion

  • Artikel

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