SWbemObject.Associators-Methode _

Die Associators-Methode _ des SWbemObject-Objekts gibt eine Auflistung 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 aus wie die ASSOCIATORS OF WQL-Abfrage.

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, die eine Zuordnungsklasse enthält. Wenn angegeben, gibt dieser Parameter an, dass die zurückgegebenen Endpunkte der Quelle über die angegebene Zuordnungsklasse oder eine von dieser Zuordnungsklasse abgeleitete Klasse zugeordnet werden müssen.

strResultClass [ in, optional]

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

strResultRole [ in, optional]

Eine Zeichenfolge, die einen Eigenschaftennamen enthält. Wenn angegeben, gibt dieser Parameter an, dass die zurückgegebenen Endpunkte in ihrer 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 Eigenschaftennamen enthält. Wenn angegeben, gibt dieser Parameter an, dass die zurückgegebenen Endpunkte an einer Zuordnung zum Quellobjekt teilnehmen müssen, in dem 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 anstelle 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 und nicht für die Daten gilt. 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 True stellen die zurückgegebenen Endpunkte Klassen dar, die der Quellklasse im Schema entsprechend zugeordnet sind.

strRequiredAssocQualifier [ in, optional]

Eine Zeichenfolge, die einen Qualifizierernamen enthält. Dieser Parameter gibt 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, die einen Qualifizierernamen enthält. Wenn dieser Parameter angegeben ist, gibt er an, dass die zurückgegebenen Endpunkte 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. Dadurch wird der Aufruf sofort zurückgegeben, anstatt zu warten, bis die Abfrage abgeschlossen ist. Dieser Parameter kann die folgenden Werte akzeptieren.

wbemFlagForwardOnly** (32 (0x20))

Bewirkt, dass ein vorwärts enumerator zurückgegeben wird. Vorwärts-Enumeratoren sind im Allgemeinen viel schneller und verwenden weniger Arbeitsspeicher als herkömmliche Enumeratoren, aber sie lassen keine Aufrufe von SWbemObject.Clone zu. _

wbemFlagBidirectional( (0 (0x0))

Bewirkt, dass WMI Zeiger auf Objekte der Enumeration beibehalten, bis der Client den Enumerator frei gibt.

wbemFlagReturnImmediately( (16 (0x10))

Bewirkt, dass der Aufruf sofort zurückkehrt.

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ück gibt. Durch die Einbeziehung dieses Flags wird der lokalisierte Beschreibungsqualifizierertext für Klassen, Eigenschaften und Methoden verfügbar. 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 bedient. 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 Associators-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 anzeigen zu können.

wbemErrFailed – 2147749889 (0x80041001)

Unbekannter Fehler.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Ein angegebener Parameter ist ungültig.

wbemErrOutOfMemory – 2147749894

Nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs.

Hinweise

Weitere Informationen zu den ASSOCIATORS OF associated WQL query, source instances, and endpoints finden Sie unter ASSOCIATORS OF Statement.

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.References_

SWbemServices.AssociatorsOf

SWbemServices.ReferencesTo