SWbemServices.SubclassesOf-Methode
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 |
|
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID_SWbemServices |
| IID |
IID_ISWbemServices |