SWbemObject.Instances-Methode _

Die Instances-Methode _ des SWbemObject-Objekts erstellt einen Enumerator, der die Instanzen des aktuellen Klassenobjekts zurückgibt. Diese Methode implementiert eine einfache Abfrage. Komplexere Abfragen erfordern möglicherweise die Verwendung von SWbemServices.ExecQuery.

Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skripterstellungs-API.

Syntax

objWbemObjectSet = .Instances_( _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

Parameter

iFlags [ in, optional]

Ganze Zahl, die das Verhalten des Aufrufs bestimmt. Dieser Parameter kann die folgenden Werte akzeptieren.

wbemFlagForwardOnly** (32 (0x20))

Bewirkt, dass ein vorwärts gerichteter Enumerator zurückgegeben wird. Vorwärts-Enumeratoren sind im Allgemeinen viel schneller und verwenden weniger Arbeitsspeicher als herkömmliche Enumeratoren, lassen jedoch keine Aufrufe von SWbemObject.Clone _zu.

wbemFlagBidirectional** (0 (0x0))

Bewirkt, dass WMI Zeiger auf Objekte der Enumeration beibehält, bis der Client den Enumerator freigibt.

wbemFlagReturnImmediately** (16 (0x10))

Standardwert für diesen Parameter. Dieses Flag bewirkt, dass der Aufruf sofort zurückgegeben wird.

wbemFlagReturnWhenComplete( 0 (0x0))

Bewirkt, dass dieser Aufruf blockiert wird, bis die Abfrage abgeschlossen ist.

wbemQueryFlagShallow( (1 (0x1))

Erzwingt, dass die Enumeration nur direkte Unterklassen der angegebenen übergeordneten Klasse einschließt.

wbemQueryFlagDeep( 0 (0x0))

Der Standardwert für diesen Parameter. Dieser Wert erzwingt, dass die Enumeration alle Klassen in der Hierarchie einschließt.

wbemFlagUseAmendedQualifiers( (131072 (0x20000))

Bewirkt, dass WMI Klassenänderungsdaten mit der Basisklassendefinition zurückgibt.

objwbemNamedValueSet [ in, optional]

In der Regel ist dies nicht definiert. Andernfalls ist dies ein SWbemNamedValueSet-Objekt, dessen Elemente die Kontextinformationen darstellen, die vom Anbieter verwendet werden können, der die Anforderung wartet. Ein Anbieter, der solche Informationen unterstützt oder erfordert, muss die erkannten Wertnamen, den Datentyp des Werts, die zulässigen Werte und die Semantik dokumentieren.

Rückgabewert

Wenn die Methode erfolgreich ist, wird ein SWbemObjectSet-Objekt zurückgegeben.

Fehlercodes

Nach Abschluss der Instances-Methode _ kann das Err-Objekt einen der Fehlercodes in der folgenden Liste enthalten.

wbemErrAccessDenied – 2147749891 (0x80041003)

Der aktuelle Benutzer verfügt nicht über die Berechtigung zum Anzeigen von Instanzen der angegebenen Klasse.

wbemErrFailed – 2147749889 (0x80041001)

Nicht angegebener Fehler.

wbemErrInvalidClass – 2147749904 (0x80041010)

Die angegebene Klasse ist ungültig.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Ein angegebener Parameter ist ungültig.

wbemErrOutOfMemory – 2147749894 (0x80041006)

Nicht genügend Arbeitsspeicher, um den Vorgang abzuschließen.

Hinweise

Die Instances-Methode _ funktioniert nur für Klassenobjekte. Es ist kein Fehler, dass die zurückgegebene Auflistung 0 Elemente enthält. Das Standardverhalten für diese Methode ist aufgrund des IFlags-Standardwerts wbemFlagReturnImmediately semisynchron.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
Header
Wbemdisp.h
Typbibliothek
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemObject
IID
IID _ ISWbemObject

Siehe auch

Swbemobject

SWbemObjectSet