QualifierSet_BeginEnumeration-Funktion

  • Artikel

Setzt einen Enumerator der Qualifizierer eines Objekts 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 QualifierSet_BeginEnumeration (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags
);

Parameter

vFunc
[in] Dieser Parameter wird nicht verwendet.

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

lFlags
[in] Eine bitweise Kombination der im Abschnitt Hinweise beschriebenen Flags oder Werte, die die Qualifizierer angibt, die in die Enumeration eingeschlossen werden sollen.

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 Der lFlags-Parameter ist ungültig.
WBEM_E_UNEXPECTED 0x8004101d Ein zweiter Aufruf von QualifierSet_BeginEnumeration wurde ohne einen dazwischen liegenden Aufruf von QualifierSet_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 IWbemQualifierSet::BeginEnumeration-Methode.

Um alle Qualifizierer eines Objekts aufzulisten, muss diese Methode vor dem ersten Aufruf von QualifierSet_Next aufgerufen werden. Die Unveränderlichkeit der Reihenfolge, in der Qualifizierer aufgelistet werden, wird für eine bestimmte Enumeration garantiert.

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.

Konstante Wert BESCHREIBUNG
0 Die Namen aller Qualifizierer zurückgeben.
WBEM_FLAG_LOCAL_ONLY 0x10 Nur die Namen von Qualifizierern zurückgeben, die für die aktuelle Eigenschaft oder das aktuelle Objekt spezifisch sind.
Für eine Eigenschaft: Nur die Qualifizierer zurückgeben, die für die Eigenschaft spezifisch sind (einschließlich Überschreibungen), und nicht die Qualifizierer, die aus der Klassendefinition weitergegeben werden.
Für eine Instanz: Nur instanzspezifische Qualifizierernamen zurückgeben.
Für eine Klasse: Nur Qualifizierer zurückgeben, die für die Klasse spezifisch sind, die abgeleitet wird.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Nur die Namen der Qualifizierer zurückgeben, die aus einem anderen Objekt weitergegeben werden.
Für eine Eigenschaft: Nur die Qualifizierer zurückgeben, die aus der Klassendefinition an diese Eigenschaft weitergegeben werden, und nicht die Qualifizierer aus der Eigenschaft selbst.
Für eine Instanz: Nur die Qualifizierer zurückgeben, die aus der Klassendefinition weitergegeben werden.
Für eine Klasse: Nur die von den übergeordneten Klassen geerbten Qualifizierernamen zurückgeben.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: WMINet_Utils.idl

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

Siehe auch