BeginEnumeration-Funktion

  • Artikel

Setzt den Enumerator auf den Anfang der Enumeration zurück.

Hinweis

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

Syntax

HRESULT BeginEnumeration (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lEnumFlags
);

Parameter

vFunc
[in] Dieser Parameter wird nicht verwendet.

ptr
[in] Ein Zeiger auf eine IWbemClassObject-Instanz.

lEnumFlags
[in] Eine bitweise Kombination der im Abschnitt Hinweise beschriebenen Flags oder Werte, die bestimmt, welche Eigenschaften in die Enumeration eingeschlossen werden.

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_INVALID_PARAMETER 0x80041008 Die Kombination von Flags in lEnumFlags ist ungültig, oder es wurde ein ungültiges Argument angegeben.
WBEM_E_UNEXPECTED 0x8004101d Ein zweiter Aufruf von BeginEnumeration wurde ohne einen dazwischen liegenden Aufruf von EndEnumeration ausgeführt.
WBEM_E_OUT_OF_MEMORY 0x80041006 Es ist nicht genügend Arbeitsspeicher verfügbar, um eine neue Enumeration zu starten.
WBEM_S_NO_ERROR 0 Der Funktionsaufruf war erfolgreich.

Bemerkungen

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

Die Flags, die als lEnumFlags-Argument übergeben werden können, werden in der WbemCli.h-Headerdatei definiert, oder Sie können sie als Konstanten in Ihrem Code definieren. Sie können ein Flag aus jeder Gruppe mit jedem Flag aus jeder anderen Gruppe kombinieren. Flags aus derselben Gruppe schließen sich jedoch gegenseitig aus.

Gruppe 1

Konstante Wert Beschreibung
WBEM_FLAG_KEYS_ONLY 0x4 Schließen Sie Eigenschaften ein, die nur den Schlüssel darstellen.
WBEM_FLAG_REFS_ONLY 0x8 Schließen Sie Eigenschaften ein, die nur Objektverweise sind.

Gruppe 2

Konstante Wert Beschreibung
WBEM_FLAG_SYSTEM_ONLY 0x30 Beschränken Sie die Enumeration nur auf Systemeigenschaften.
WBEM_FLAG_NONSYSTEM_ONLY 0x40 Schließen Sie lokale und weitergegebene Eigenschaften ein, schließen Sie jedoch Systemeigenschaften von der Enumeration aus.

Für Klassen:

Konstante Wert BESCHREIBUNG
WBEM_FLAG_CLASS_OVERRIDES_ONLY 0x100 Beschränken Sie die Enumeration auf Eigenschaften, die in der Klassendefinition überschrieben werden.
WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES 0x100 Beschränken Sie die Enumeration auf Eigenschaften, die in der aktuellen Klassendefinition überschrieben werden, und auf neue Eigenschaften, die in der Klasse definiert sind.
WBEM_MASK_CLASS_CONDITION 0x300 Eine Maske (anstelle eines Flags), die auf einen lEnumFlags-Wert angewendet werden soll, um zu überprüfen, ob WBEM_FLAG_CLASS_OVERRIDES_ONLY oder WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES festgelegt ist.
WBEM_FLAG_LOCAL_ONLY 0x10 Beschränken Sie die Enumeration auf Eigenschaften, die in der Klasse selbst definiert oder geändert werden.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Beschränken Sie die Aufzählung auf Eigenschaften, die von Basisklassen geerbt werden.

Für Instanzen:

Konstante Wert BESCHREIBUNG
WBEM_FLAG_LOCAL_ONLY 0x10 Beschränken Sie die Enumeration auf Eigenschaften, die in der Klasse selbst definiert oder geändert werden.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Beschränken Sie die Aufzählung auf Eigenschaften, die von Basisklassen geerbt werden.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

.NET Framework-Versionen: Seit Version 4.7.2 verfügbar

Siehe auch