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, die eine -Klasse sein muss. Elemente in der zurückgegebenen Auflistung können mithilfe von Standardauflistungsmethoden abgerufen werden. Weitere Informationen finden Sie unter Zugreifen auf eine Sammlung.
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]
-
Ganze Zahl, die bestimmt, wie detailliert der Aufruf aufzählt. Dieser Parameter kann die folgenden Werte akzeptieren.
-
wbemQueryFlagDeep( 0 (0x0))
-
Erzwingt die rekursive Enumeration in alle Unterklassen, die von 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. Er erzwingt, dass die -Enumeration nur direkt Unterklassen der angegebenen übergeordneten Klasse einschließt.
-
WbemFlagReturnImmediately( (16 (0x10))
-
Bewirkt, dass der Aufruf sofort zurückgegeben wird
-
wbemFlagReturnWhenComplete( (0 (0x0))
-
Bewirkt, dass dieser Aufruf blockiert wird, bis der Aufruf abgeschlossen ist.
-
wbemFlagUseAmendedQualifiers( (131072 (0x20000))
-
Bewirkt, dass WMI Klassenänderungsdaten zusammen 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 der Aufruf erfolgreich ist, wird ein SWbemObjectSet-Objekt zurückgegeben.
Fehlercodes
Nach Abschluss der Methode _ "Subclasses" kann das Err-Objekt einen der Fehlercodes in der folgenden Liste enthalten.
-
wbemErrAccessDenied – 2147749891 (0x80041003)
-
Der aktuelle Benutzer verfügt nicht über die Berechtigung, eine oder mehrere der vom Aufruf zurückgegebenen Klassen anzuzeigen.
-
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)
-
Nicht genügend Arbeitsspeicher, um den Vorgang abzuschließen.
Hinweise
Es ist kein Fehler, dass die zurückgegebene Auflistung über 0 Elemente verfügt, wenn keine Unterklassen des aktuellen Objekts vorhanden sind. Die Methode _ "Subclasses" funktioniert nur für Klassenobjekte.
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 |