IWbemQualifierSet::BeginEnumeration-Methode (wbemcli.h)

  • Artikel

Die IWbemQualifierSet::BeginEnumeration-Methode wird zurückgesetzt, bevor eine Enumeration aller Qualifizierer im -Objekt vorhanden ist. Um alle Qualifizierer für ein Objekt aufzulisten, muss diese Methode vor dem ersten Aufruf von IWbemQualifierSet::Next aufgerufen werden. Die Reihenfolge, in der Qualifizierer aufgelistet werden, ist für eine bestimmte instance von IWbemQualifierSet garantiert invariant.

Syntax

HRESULT BeginEnumeration(
  [in] long lFlags
);

Parameter

[in] lFlags

Gibt die Qualifizierer an, die in die Enumeration eingeschlossen werden sollen. Dabei muss es sich um eine der folgenden Konstanten handeln.

0 (Null)

Die Namen aller Qualifizierer zurückgeben.

WBEM_FLAG_LOCAL_ONLY

Nur die Namen von Qualifizierern zurückgeben, die für die aktuelle Eigenschaft oder das aktuelle Objekt spezifisch sind. Wenn der aktuelle Qualifizierersatz auf eine Eigenschaft verweist, geben Sie nur die Qualifizierer zurück, die für die Eigenschaft spezifisch sind (einschließlich Überschreibungen), und nicht die Qualifizierer, die aus der Klassendefinition weitergegeben werden. Wenn der aktuelle Qualifizierersatz auf einen instance verweist, geben Sie nur instance spezifischen Qualifizierernamen zurück. Wenn der aktuelle Qualifizierersatz auf eine Klasse verweist, geben Sie nur Qualifizierer zurück, die für die abgeleitete Klasse spezifisch sind.

WBEM_FLAG_PROPAGATED_ONLY

Nur die Namen der Qualifizierer zurückgeben, die aus einem anderen Objekt weitergegeben werden. Wenn der aktuelle Qualifizierersatz beispielsweise auf eine Eigenschaft verweist, geben Sie nur die Qualifizierer zurück, die aus der Klassendefinition an diese Eigenschaft weitergegeben wurden, und nicht die Qualifizierer aus der Eigenschaft selbst. Wenn der aktuelle Qualifizierersatz auf einen instance verweist, geben Sie nur die Qualifizierer zurück, die aus der Klassendefinition weitergegeben wurden. Wenn der aktuelle Qualifizierersatz auf eine Klasse verweist, geben Sie nur die von den übergeordneten Klassen geerbten Qualifizierernamen zurück.

Rückgabewert

Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt. Die folgende Liste listet den Wert auf, der in einem HRESULT enthalten ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile wbemcli.h (include Wbemidl.h)
Bibliothek Wbemuuid.lib
DLL Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll

Weitere Informationen

IWbemQualifierSet

IWbemQualifierSet::Next