SWbemServices.ReferencesTo-Methode

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 aus, die die VERWEISE VON WQL-Abfrage ausführt.

Diese 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 Skripting-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 Beschreibung 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 oder abgeleitet werden müssen, die in diesem Parameter angegeben ist.

strRole [optional]

Zeichenfolge, die einen Eigenschaftsnamen enthält. Wenn angegeben, gibt dieser Parameter an, dass die zurückgegebenen Zuordnungsobjekte auf diejenigen beschränkt sein müssen, in denen das Quellobjekt eine bestimmte Rolle spielt. Die Rolle wird durch den Namen einer angegebenen Eigenschaft (die eine Referenzeigenschaft sein muss) einer Zuordnung definiert.

bClassesOnly [optional]

Boolescher Wert, der angibt, ob anstelle tatsächlicher Instanzen der Klassen eine Liste mit Klassennamen zurückgegeben werden soll. Dies sind die Klassen, zu denen die Zuordnungsobjekte gehören. Der Standardwert für diesen 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 diesen Parameter ist FALSE. Er kann nur auf TRUE festgelegt werden, wenn der strObjectPath-Parameter den Objektpfad einer Klasse angibt. Wenn dieser Wert auf TRUE festgelegt ist, stellt der Satz zurückgegebener 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, wodurch der Aufruf sofort zurückgegeben wird, anstatt zu warten, bis die Abfrage abgeschlossen wurde. Dieser Parameter kann die folgenden Werte akzeptieren.

wbemFlagForwardOnly (32 (0x20))

Bewirkt, dass eine Weiterleitungs-Aufzählung zurückgegeben wird. Forward-only-Enumerationen sind im Allgemeinen viel schneller und verwenden weniger Arbeitsspeicher als herkömmliche Enumerationen, aber sie erlauben keine Aufrufe, SWbemObject.Clone_.

wbemFlagBidirectional (0 (0x0))

Bewirkt, dass Windows Verwaltungsinstrumentation (WMI) Zeiger auf Objekte der Enumeration beibehalten, bis der Client den Enumerationsgeber losgibt.

wbemFlagReturnImmediately (16 (0x10))

Bewirkt, dass der Aufruf sofort zurückgegeben wird.

wbemFlagReturnWhenComplete (0 (0x0))

Bewirkt, dass dieser Aufruf blockiert wird, bis die Abfrage abgeschlossen wurde. Dieses Flag ruft die Methode im synchronen Modus auf.

wbemFlagUseAmendedQualifiers (131072 (0x20000))

Bewirkt, dass WMI Klassenänderungsdaten zusammen mit der Basisklassendefinition zurückzugeben. Weitere Informationen finden Sie unter Lokalisieren von WMI-Klasseninformationen.

objWbemNamedValueSet [optional]

In der Regel ist dies nicht definiert. Andernfalls handelt es sich um ein SWbemNamedValueSet-Objekt , dessen Elemente die Kontextinformationen darstellen, die vom Anbieter verwendet werden können, der die Anforderung gewartet. Ein Anbieter, der solche Informationen unterstützt oder erfordert, muss die erkannten Wertnamen, den Datentyp des Werts, zulässige Werte und Semantik dokumentieren.

Rückgabewert

Wenn die Methode erfolgreich ist, gibt die Methode ein SWbemObjectSet - Objekt zurück.

Fehlercodes

Nach Abschluss der ReferencesTo-Methode kann das Err-Objekt eine der Fehlercodes in der folgenden Liste enthalten.

Hinweis

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

wbemErrAccessDenied - 2147749891 (0x80041003)

Der aktuelle Benutzer verfügt nicht über die Berechtigung zum Anzeigen einer oder mehrerer der vom Aufruf zurückgegebenen Klassen.

wbemErrFailed - 2147749889 (0x80041001)

Unbekannter Fehler.

wbemErrInvalidParameter - 2147749896 (0x80041008)

Ungültiger Parameter wurde angegeben.

wbemErrOutOfMemory - 2147749894 (0x80041006)

Nicht genügend Arbeitsspeicher, um den Vorgang abzuschließen.

wbemFlagUseAmendedQualifiers - 131072 (0x20000)

Bewirkt, dass WMI Klassenänderungsdaten mit der Basisklassendefinition zurückzugeben.

Bemerkungen

Weitere Informationen zu den ZUGEHÖRIGEN WQL-Abfragen, Quellinstanzen und Zuordnungsobjekten finden Sie unter ASSOCIATORS OF Statement.

Requirements (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

SWbemObject.Associators_

SWbemObject.References_

SWbemServices.AssociatorsOf