Methode SWbemServices.ReferencesTo
Die ReferencesTo-Methode des SWbemServices-Objekts gibt eine Auflistung aller Zuordnungsklassen oder -instanzen zurück, die auf eine bestimmte Quellklasse oder -instanz verweisen. Diese Methode führt dieselbe Funktion wie die WQL-Abfrage REFERENCES OF aus.
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 = .ReferencesTo( _
ByVal strObjectPath, _
[ ByVal strResultClass ], _
[ ByVal strRole ], _
[ ByVal bClassesOnly ], _
[ ByVal bSchemaOnly ], _
[ ByVal strRequiredQualifier ], _
[ ByVal iFlags ], _
[ ByVal objWbemNamedValueSet ] _
)
Parameter
-
strObjectPath
-
Erforderlich. Zeichenfolge, die den Objektpfad der Quelle für diese Methode enthält. Weitere Informationen finden Sie unter Beschreiben des Speicherorts eines WMI-Objekts.
-
strResultClass [optional]
-
Zeichenfolge, die einen Klassennamen enthält. Wenn angegeben, gibt dieser Parameter an, dass die zurückgegebenen Zuordnungsobjekte zu der Klasse gehören müssen, die in diesem Parameter angegeben ist, oder von ihr abgeleitet werden müssen.
-
strRole [optional]
-
Eine Zeichenfolge, die einen Eigenschaftsnamen enthält. Wenn angegeben, gibt dieser Parameter an, dass die zurückgegebenen Zuordnungsobjekte auf diejenigen beschränkt werden müssen, in denen das Quellobjekt eine bestimmte Rolle spielt. Die Rolle wird durch den Namen einer angegebenen Eigenschaft (die eine Verweiseigenschaft sein muss) einer Zuordnung definiert.
-
bClassesOnly [optional]
-
Boolescher Wert, der angibt, ob anstelle der tatsächlichen Instanzen der Klassen eine Liste von Klassennamen zurückgegeben werden soll. Dies sind die Klassen, zu denen die Zuordnungsobjekte gehören. Der Standardwert für den Parameter ist FALSE.
-
bSchemaOnly [optional]
-
Boolescher Wert, der angibt, ob die Abfrage nicht für die Daten, sondern für das Schema gilt. Der Standardwert für den Parameter ist FALSE. Er kann nur auf TRUE festgelegt werden, wenn der strObjectPath-Parameter den Objektpfad einer Klasse angibt. Wenn er auf TRUE festgelegt wird, stellt der Satz der zurückgegebenen Endpunkte Klassen dar, die der Quellklasse im Schema entsprechend zugeordnet sind.
-
strRequiredQualifier [optional]
-
Zeichenfolge, die einen Qualifizierernamen enthält. Wenn angegeben, gibt dieser Parameter an, dass die zurückgegebenen Zuordnungsobjekte den angegebenen Qualifizierer enthalten müssen.
-
iFlags [optional]
-
Ganze Zahl, die zusätzliche Flags für den Vorgang angibt. Der Standardwert für diesen Parameter ist wbemFlagReturnImmediately. Dadurch wird der Aufruf zu einer sofortigen Rückgabe veranlasst, anstatt zu warten, bis die Abfrage abgeschlossen ist. Dieser Parameter kann die folgenden Werte akzeptieren.
-
wbemFlagForwardOnly (32 (0x20))
-
Bewirkt, dass ein Forward-Only-Enumerator zurückgegeben wird. Forward-Only-Enumeratoren sind normalerweise viel schneller und beanspruchen weniger Arbeitsspeicher als herkömmliche Enumeratoren, lassen aber keine Aufrufe von SWbemObject.Clone_ zu.
-
wbemFlagBidirectional (0 (0x0))
-
Bewirkt, dass die Windows-Verwaltungsinstrumentation (WMI) Zeiger auf Objekte der Enumeration beibehält, bis der Client den Enumerator freigibt.
-
wbemFlagReturnImmediately (16 (0x10))
-
Bewirkt, dass der Aufruf sofort abgeschlossen wird.
-
wbemFlagReturnWhenComplete (0 (0x0))
-
Bewirkt, dass dieser Aufruf blockiert wird, bis die Abfrage abgeschlossen ist. Dieses Flag ruft die Methode im synchronen Modus auf.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Bewirkt, dass WMI Klassenänderungsdaten zusammen mit der Basisklassendefinition zurückgibt. Weitere Informationen finden Sie unter Lokalisieren von WMI-Klasseninformationen.
objWbemNamedValueSet [optional]
Dies ist 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 die Methode erfolgreich ist, gibt die Methode ein SWbemObjectSet-Objekt zurück.
Fehlercodes
Nach Abschluss der Methode InstancesOf 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.
-
wbemErrInvalidParameter – 2147749896 (0x80041008)
-
Es wurde ein ungültiger Parameter angegeben.
-
wbemErrOutOfMemory – 2147749894 (0x80041006)
-
Es steht nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs zur Verfügung.
-
wbemFlagUseAmendedQualifiers – 131072 (0x20000)
-
Bewirkt, dass WMI Klassenänderungsdaten mit der Basisklassendefinition zurückgibt.
Bemerkungen
Weitere Informationen zur REFERENCES OF zugeordneten WQL-Abfrage, Quellinstanzen und Zuordnungsobjekten finden Sie unter ASSOCIATORS OF-Anweisung.
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 |