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 in den 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 Forward-Only-Enumerator zurückgegeben wird. Forward-Only-Enumeratoren sind normalerweise viel schneller und beanspruchen weniger Arbeitsspeicher als herkömmliche Enumeratoren, lassen aber keine Aufrufe von SWbemObject.Clone_ zu.
-
wbemFlagBidirectional (0 (0x0))
-
Bewirkt, dass WMI Zeiger auf Objekte der Enumeration so lange beibehält, bis der Client den Enumerator freigibt.
-
wbemFlagReturnImmediately (16 (0x10))
-
Standardwert für diesen Parameter. Dieses Flag bewirkt, dass der Aufruf sofort abgeschlossen wird.
-
wbemFlagReturnWhenComplete (0 (0x0))
-
Bewirkt, dass dieser Aufruf so lange blockiert wird, bis die Abfrage abgeschlossen ist.
-
wbemQueryFlagShallow (1 (0x1))
-
Erzwingt, dass die Enumeration nur direkte Unterklassen der angegebenen übergeordneten Klasse enthält.
-
wbemQueryFlagDeep (0 (0x0))
-
Standardwert für diesen Parameter. Dieser Wert bewirkt, dass die Enumeration alle Klassen in der Hierarchie umfasst.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Bewirkt, dass WMI Klassenänderungsdaten mit der Basisklassendefinition zurückgibt.
objwbemNamedValueSet [in, optional]
In der Regel nicht definiert. Andernfalls handelt es sich um ein SWbemNamedValueSet-Objekt, dessen Elemente die Kontextinformationen darstellen, die von dem Anbieter verwendet werden können, der die Anforderung verarbeitet. Ein Anbieter, der solche Informationen unterstützt oder benötigt, muss die erkannten Wertnamen, den Datentyp des Werts, die zulässigen Werte und die Semantik dokumentieren.
Rückgabewert
Bei erfolgreicher Ausführung der Methode wird ein SWbemObjectSet-Objekt zurückgegeben.
Fehlercodes
Nach Abschluss der Instances_-Methode enthält das Err-Objekt möglicherweise einen der Fehlercodes aus der folgenden Liste:
-
wbemErrAccessDenied – 2147749891 (0x80041003)
-
Der aktuelle Benutzer bzw. die aktuelle Benutzerin ist nicht zum Anzeigen von Instanzen der angegebenen Klasse berechtigt.
-
wbemErrFailed – 2147749889 (0x80041001)
-
Ein unbekannter Fehler ist aufgetreten.
-
wbemErrInvalidClass – 2147749904 (0x80041010)
-
Die angegebene Klasse ist ungültig.
-
wbemErrInvalidParameter – 2147749896 (0x80041008)
-
Ein angegebener Parameter ist ungültig.
-
wbemErrOutOfMemory – 2147749894 (0x80041006)
-
Es ist nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs vorhanden.
Bemerkungen
Die Instances_-Methode funktioniert nur für Klassenobjekte. Es ist kein Fehler, wenn die zurückgegebene Sammlung null Elemente hat. Aufgrund des IFlags-Standardwerts wbemFlagReturnImmediately ist das Standardverhalten für diese Methode halbsynchron.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
Windows Server 2008 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID_SWbemObject |
| IID |
IID_ISWbemObject |