SWbemServices.SubclassesOf-Methode

Artikel
07/03/2023

Die SubclassesOf-Methode des SWbemServices-Objekts gibt ein SWbemObjectSet-Objekt zurück. Dieses Objekt ist eine Sammlung von Unterklassen einer angegebenen Klasse. Elemente in der zurückgegebenen Sammlung können mithilfe von Standardsammlungsmethoden abgerufen werden. Weitere Informationen finden Sie unter Zugreifen auf eine Sammlung.

Diese Methode funktioniert nur für Klassenobjekte.

Die Methode wird im semisynchronen Modus aufgerufen. Weitere Informationen finden Sie unter Aufrufen einer Methode.

Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skript-API.

Syntax

objWbemObjectSet = .SubclassesOf( _
  [ ByVal strSuperclass ], _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ] _
)

Parameter

strSuperclass [optional]: Gibt den Namen einer übergeordneten Klasse an. Nur Unterklassen dieser Klasse werden im Enumerator zurückgegeben. Wenn Sie diesen Parameter leer lassen und iFlags auf wbemQueryFlagShallow festgelegt ist, werden nur die Klassen der obersten Ebene zurückgegeben (d. h. Klassen ohne übergeordnete Klasse). Wenn dieser Parameter leer ist und iFlags auf wbemQueryFlagDeep festgelegt ist, werden alle Klassen innerhalb des Namespace zurückgegeben.
iFlags [optional]: Bestimmt, wie detailliert der Aufruf aufgezählt wird. Die Standardwerte für diesen Parameter sind wbemFlagReturnImmediately und wbemQueryFlagDeep. Dieser Parameter kann die folgenden Werte annehmen.
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 erzwingt die rekursive Enumeration aller Unterklassen, die von der angegebenen übergeordneten Klasse abgeleitet werden. Die übergeordnete Klasse wird in der Enumeration nicht zurückgegeben.
wbemFlagReturnImmediately (16 (0x10)): Bewirkt, dass der Aufruf sofort abgeschlossen wird.
wbemFlagReturnWhenComplete (0 (0x0)): Bewirkt, dass dieser Aufruf blockiert wird, bis der Aufruf abgeschlossen ist. Dieses Flag ruft die Methode im synchronen Modus auf.
wbemFlagUseAmendedQualifiers (131072 (0x20000)): Bewirkt, dass WMI Klassenänderungsdaten mit der Basisklassendefinition zurückgibt. Weitere Informationen finden Sie unter Lokalisieren von WMI-Klasseninformationen.

objWbemNamedValueSet [optional]

Dies wird normalerweise nicht definiert. Andernfalls handelt es sich um ein SWbemNamedValueSet-Objekt, dessen Elemente die Kontextinformationen darstellen, die von dem Anbieter, der die Anforderung verarbeitet, verwendet werden können. 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 die Methode erfolgreich ist, wird ein SWbemObjectSet-Objekt zurückgegeben.

Fehlercodes

Nach Abschluss derSubclassesOf-Methode enthält das Err-Objekt möglicherweise einen der Fehlercodes aus der folgenden Liste.

Hinweis

Eine zurückgegebene Sammlung mit null Elementen ist kein Fehler.

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 ist 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.

Beispiele

Das folgende PowerShell-Beispiel zeigt, wie die Unterklassen einer Klasse auf einem Remotesystem abgerufen werden.

$NameSpace = 'root\ccm'
$ComputerName = 'sccm.company.com'
$WbemLocator = New-Object -ComObject "WbemScripting.SWbemLocator"
$WbemServices = $WbemLocator.ConnectServer($ComputerName, $Namespace)
$WbemClasses = $WbemServices.SubclassesOf()
$WbemClasses

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_SWbemServices
IID	IID_ISWbemServices

Weitere Informationen

SWbemServices
SWbemObjectSet