SWbemObject.Subclasses_-Methode
Die Subclasses_-Methode des SWbemObject-Objekts gibt ein SWbemObjectSet-Objekt zurück. Dieses Objekt ist eine Auflistung von Unterklassen des aktuellen Objekts, bei dem es sich um eine Klasse handeln muss. Elemente in der zurückgegebenen Auflistung können mithilfe von Standardauflistungsmethoden abgerufen werden. Weitere Informationen finden Sie unter Zugreifen auf eine Auflistung.
Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skripterstellungs-API.
Syntax
objWbemObjectSet = .Subclasses_( _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ] _
)
Parameter
-
iFlags [in, optional]
-
Ganzzahl, die bestimmt, wie detailliert der Aufruf enumeriert wird. Dieser Parameter kann die folgenden Werte akzeptieren.
-
wbemQueryFlagDeep (0 (0x0))
-
Erzwingt die rekursive Enumeration aller Unterklassen, die aus der angegebenen übergeordneten Klasse abgeleitet werden. Die übergeordnete Klasse selbst wird in der Enumeration nicht zurückgegeben.
-
wbemQueryFlagShallow (1 (0x1))
-
Standardwert für diesen Parameter. Erzwingt, dass die Enumeration nur direkte Unterklassen der angegebenen übergeordneten Klasse enthält.
-
wbemFlagReturnImmediately (16 (0x10))
-
Bewirkt, dass der Aufruf sofort zurückgegeben wird.
-
wbemFlagReturnWhenComplete (0 (0x0))
-
Bewirkt, dass dieser Aufruf so lange blockiert wird, bis er abgeschlossen ist.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Bewirkt, dass WMI Klassenänderungsdaten zusammen 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
Wenn der Aufruf erfolgreich ist, wird ein SWbemObjectSet-Objekt zurückgegeben.
Fehlercodes
Nach Abschluss derSubclasses_-Methode enthält das Err-Objekt möglicherweise einen der Fehlercodes aus der folgenden Liste.
-
wbemErrAccessDenied – 2147749891 (0x80041003)
-
Der aktuelle Benutzer oder die aktuelle Benutzerin verfügt nicht über die Berechtigung zum Anzeigen einer oder mehrerer Klassen, die vom Aufruf zurückgegeben werden.
-
wbemErrFailed – 2147749889 (0x80041001)
-
Unbekannter Fehler.
-
wbemErrInvalidClass – 2147749904 (0x80041010)
-
Die angegebene Klasse war nicht vorhanden.
-
wbemErrInvalidParameter – 2147749896 (0x80041008)
-
Es wurde ein ungültiger Parameter angegeben.
-
wbemErrOutOfMemory – 2147749894 (0x80041006)
-
Es ist nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs vorhanden.
Bemerkungen
Es ist kein Fehler, dass die zurückgegebene Auflistung 0 Elemente enthält, wenn keine Unterklassen des aktuellen Objekts vorhanden sind. Die Subclasses_-Methode funktioniert nur bei Klassenobjekten.
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 |