QualifierSet_BeginEnumeration-Funktion

Artikel
06/02/2023

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

WMI und Leistungsindikatoren (Referenz zur nicht verwalteten API)

Freigeben über