SWbemObject.References-Methode _

Die _ References-Methode des SWbemObject-Objekts gibt eine Auflistung aller Zuordnungsklassen oder Instanzen zurück, die auf das aktuelle Objekt verweisen.

Diese Methode führt die gleiche Funktion wie die REFERENCES OF WQL-Abfrage aus.

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

Syntax

objWbemObjectSet = .References_( _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

Parameter

strResultClass [ in, optional]

Zeichenfolge, die einen Klassennamen enthält. Wenn angegeben, gibt dieser Parameter an, dass die zurückgegebenen Zuordnungsobjekte zu der in diesem Parameter angegebenen Klasse gehören oder von dieser abgeleitet werden müssen.

strRole [ in, optional]

Zeichenfolge, die einen Eigenschaftennamen enthält. Falls angegeben, gibt dieser Parameter an, dass die zurückgegebenen Zuordnungsobjekte auf die Objekte 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 [ in, optional]

Ein boolescher Wert, der angibt, ob eine Liste von Klassennamen anstelle von tatsächlichen Instanzen der Klassen zurückgegeben werden soll. Dies sind die Klassen, zu denen die Zuordnungsobjekte gehören. Der Standardwert für diesen Parameter ist FALSE.

bSchemaOnly [ in, optional]

Boolescher Wert, der angibt, ob die Abfrage auf das Schema und nicht auf die Daten angewendet wird. Der Standardwert für diesen Parameter ist FALSE. Sie kann nur auf TRUE festgelegt werden, wenn das Objekt, für das diese Methode aufgerufen wird, eine Klasse ist. Bei Festlegung auf TRUE stellt der Satz zurückgegebener Endpunkte Klassen dar, die der Quellklasse im Schema entsprechend zugeordnet sind.

strRequiredQualifier [ in, 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 [ in, optional]

Ganze Zahl, die zusätzliche Flags für den Vorgang angibt. Der Standardwert für diesen Parameter ist wbemFlagReturnImmediately, der den Aufruf anleitet, sofort zurückzukehren, anstatt zu warten, bis die Abfrage abgeschlossen ist. Dieser Parameter kann die folgenden Werte akzeptieren.

wbemFlagForwardOnly** (32 (0x20))

Bewirkt, dass ein vorwärts gerichteter Enumerator zurückgegeben wird. Vorwärts-Enumeratoren sind im Allgemeinen viel schneller und verwenden weniger Arbeitsspeicher als herkömmliche Enumeratoren, lassen jedoch keine Aufrufe von SWbemObject.Clone _zu.

wbemFlagBidirectional** (0 (0x0))

Bewirkt, dass Windows Management Instrumentation (WMI) Zeiger auf Objekte der Enumeration beibehält, bis der Client den Enumerator freigibt.

wbemFlagReturnImmediately** (16 (0x10))

Bewirkt, dass der Aufruf sofort zurückgegeben wird.

wbemFlagReturnWhenComplete( (0 (0x0))

Bewirkt, dass dieser Aufruf blockiert wird, bis die Abfrage abgeschlossen ist.

wbemFlagUseAmendedQualifiers( (131072 (0x20000))

Bewirkt, dass WMI Klassenänderungsdaten mit der Basisklassendefinition zurückgibt. Weitere Informationen zu geänderten Qualifizierern finden Sie unter Lokalisieren von WMI-Klasseninformationen.

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 _ References-Methode 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.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Es wurde ein ungültiger Parameter angegeben.

wbemErrOutOfMemory – 2147749894 (0x80041006)

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

Hinweise

Weitere Informationen zu den REFERENCES OF zugeordneten WQL-Abfragen, 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
Wbemdisp.h
Typbibliothek
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemObject
IID
IID _ ISWbemObject

Siehe auch

Swbemobject

SWbemObject.Associators_

SWbemServices.AssociatorsOf

SWbemServices.ReferencesTo