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
Wbemdisp.h
Typbibliothek
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemObject
IID
IID _ ISWbemObject

Siehe auch

Swbemobject

SWbemObjectSet