SWbemObject.Instances_ Methode

Die Instances_ -Methode des SWbemObject-Objekts erstellt einen Aufzählungsator, 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 Skripting-API.

Syntax

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

Parameter

iFlags [in, optional]

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

wbemFlagForwardOnly (32 (0x20))

Führt dazu, dass ein Nur-Aufzählungszeichen zurückgegeben wird. Forward-only-Enumeratoren sind in der Regel viel schneller und verwenden weniger Arbeitsspeicher als herkömmliche Aufzählungen, aber sie ermöglichen keine Aufrufe SWbemObject.Clone_.

wbemFlagBidirectional (0 (0x0))

Führt dazu, dass WMI Zeiger auf Objekte der Aufzählung beibehalten, bis der Client den Aufzählungspunkt veröffentlicht.

wbemFlagReturnImmediately (16 (0x10))

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

wbemFlagReturnWhenComplete ( 0 (0x0))

Führt dazu, dass dieser Aufruf blockiert wird, bis die Abfrage abgeschlossen ist.

wbemQueryFlagShallow (1 (0x1))

Erzwingt die Enumeration, nur direkte Unterklassen der angegebenen übergeordneten Klasse einzuschließen.

wbemQueryFlagDeep (0 (0x0))

Standard für diesen Parameter. Dieser Wert erzwingt die Aufzählung, alle Klassen in der Hierarchie einzuschließen.

wbemFlagUseAmendedQualifiers (131072 (0x20000))

Führt dazu, dass WMI Klassenänderungsdaten mit der Basisklassendefinition zurückzugeben.

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 unterstützt. Ein Anbieter, der solche Informationen unterstützt oder erfordert, muss die erkannten Wertnamen, den Datentyp des Werts, zulässige Werte und Semantik dokumentieren.

Rückgabewert

Wenn die Methode erfolgreich ist, gibt ein SWbemObjectSet-Objekt zurück.

Fehlercodes

Nach Abschluss der Instances_ -Methode kann das Err-Objekt eine der Fehlercodes in der folgenden Liste enthalten.

wbemErrAccessDenied - 2147749891 (0x80041003)

Der aktuelle Benutzer verfügt nicht über die Berechtigung, Instanzen der angegebenen Klasse anzuzeigen.

wbemErrFailed - 2147749889 (0x80041001)

Fehler, der nicht angegeben wurde.

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 zum Abschließen des Vorgangs.

Bemerkungen

Die Instances_ -Methode funktioniert nur für Klassenobjekte. Es ist kein Fehler für die zurückgegebene Auflistung, um null Elemente zu haben. Das Standardverhalten für diese Methode ist semisynchron aufgrund des Standardmäßigen IFlags-WertswbemFlagReturnImmediately.

Requirements (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

Weitere Informationen

Swbemobject

SWbemObjectSet