Methode „SWbemObject.Associators_“

Die Methode Associators_ des Objekts SWbemObject gibt eine Sammlung von Objekten (Klassen oder Instanzen) zurück, die dem aktuellen Objekt zugeordnet sind. Diese zurückgegebenen Objekte werden als „Endpunkte“ bezeichnet. Diese Methode führt dieselbe Funktion wie die WQL-Abfrage „ASSOCIATORS OF“ aus.

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

Syntax

objWbemObjectSet = .Associators_( _
  [ ByVal strAssocClass ], _
  [ ByVal strResultClass ], _
  [ ByVal strResultRole ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredAssocQualifier ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

Parameter

strAssocClass [in, optional]

Eine Zeichenfolge mit einer Zuordnungsklasse. Wenn angegeben, zeigt dieser Parameter an, dass die zurückgegebenen Endpunkte der Quelle über die angegebene Zuordnungsklasse oder eine davon abgeleitete Klasse zugeordnet werden müssen.

strResultClass [in, optional]

Eine Zeichenfolge mit einem Klassennamen. Wenn angegeben, zeigt dieser Parameter an, dass die zurückgegebenen Endpunkte zu der im Parameter angegebenen Klasse gehören oder von ihr abgeleitet werden müssen.

strResultRole [in, optional]

Eine Zeichenfolge mit einem Eigenschaftsnamen. Wenn dieser Parameter angegeben ist, weist er darauf hin, dass die zurückgegebenen Endpunkte bei deren Zuordnung zum Quellobjekt eine bestimmte Rolle spielen müssen. Die Rolle wird durch den Namen einer angegebenen Eigenschaft (die eine Verweiseigenschaft sein muss) einer Zuordnung definiert.

strRole [in, optional]

Eine Zeichenfolge, die einen Eigenschaftsnamen enthält. Wenn dieser Parameter angegeben ist, weist er darauf hin, dass die zurückgegebenen Endpunkte an einer Zuordnung zum Quellobjekt beteiligt sein müssen, bei der 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 statt der tatsächlichen Instanzen der Klassen eine Liste von Klassennamen zurückgegeben werden soll. Dies sind die Klassen, zu denen die Endpunktinstanzen gehören. Der Standardwert für diesen Parameter ist FALSE.

bSchemaOnly [in, optional]

Dies ist ein boolescher Wert, der angibt, ob die Abfrage für das Schema statt für die Daten gilt. Der Standardwert für diesen Parameter ist FALSE. Er kann nur dann auf TRUE festgelegt werden, wenn das Objekt, für das diese Methode aufgerufen wird, eine Klasse ist. Wenn er auf TRUE festgelegt wird, stellt der Satz der zurückgegebenen Endpunkte Klassen dar, die der Quellklasse im Schema entsprechend zugeordnet sind.

strRequiredAssocQualifier [in, optional]

Eine Zeichenfolge mit einem Qualifizierernamen. Wenn angegeben, zeigt dieser Parameter an, dass die zurückgegebenen Endpunkte dem Quellobjekt über eine Zuordnungsklasse zugeordnet werden müssen, die den angegebenen Qualifizierer enthält.

strRequiredQualifier [in, optional]

Eine Zeichenfolge mit einem Qualifizierernamen. Wenn angegeben, zeigt dieser Parameter an, dass die zurückgegebenen Endpunkte den angegebenen Qualifizierer enthalten müssen.

iFlags [in, optional]

Eine 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, statt 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 WMI Zeiger auf Objekte der Enumeration so lange 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 so lange blockiert wird, bis die Abfrage abgeschlossen ist.

wbemFlagUseAmendedQualifiers (131072 (0x20000))

Bewirkt, dass WMI Klassenänderungsdaten mit der Basisklassendefinition zurückgibt. Durch Einbeziehung dieses Flags wird der lokalisierte Text des Beschreibungsqualifizierers für Klassen, Eigenschaften und Methoden verfügbar gemacht. Weitere Informationen zu geänderten Qualifizierern finden Sie unter Lokalisieren von WMI-Klasseninformationen.

objwbemNamedValueSet [in, optional]

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 der Aufruf erfolgreich ist, wird ein SWbemObjectSet-Objekt zurückgegeben.

Fehlercodes

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

wbemErrAccessDenied – 2147749891 (0x80041003)

Der aktuelle Benutzer hat keine Berechtigung zum Anzeigen einer oder mehrerer der Klassen, die vom Aufruf zurückgegeben werden.

wbemErrFailed – 2147749889 (0x80041001)

Unbekannter Fehler.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Der angegebene Parameter ist ungültig.

wbemErrOutOfMemory – 2147749894

Es ist nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs vorhanden.

Bemerkungen

Weitere Informationen zur zugeordneten WQL-Abfrage „ASSOCIATORS OF“, Quellinstanzen und Endpunkten 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

Weitere Informationen

SWbemObject

SWbemObject.References_

SWbemServices.AssociatorsOf

SWbemServices.ReferencesTo