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, die die ASSOCIATORS OF WQL-Abfrage ausführt.

Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skripting-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]

Zeichenfolge, die eine Zuordnungsklasse enthält. Wenn angegeben, gibt dieser Parameter an, dass die zurückgegebenen Endpunkte über die angegebene Zuordnungsklasse oder eine von dieser Zuordnungsklasse abgeleitete Klasse der Quelle zugeordnet werden müssen.

strResultClass [in, optional]

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 abgeleitet werden müssen.

strResultRole [in, optional]

Zeichenfolge, die einen Eigenschaftennamen enthält. Wenn angegeben, gibt dieser Parameter an, dass die zurückgegebenen Endpunkte eine bestimmte Rolle in ihrer Zuordnung mit dem Quellobjekt spielen müssen. Die Rolle wird durch den Namen einer angegebenen Eigenschaft (die eine Referenzeigenschaft sein muss) einer Zuordnung definiert.

strRole [in, optional]

Zeichenfolge, die einen Eigenschaftennamen enthält. Wenn angegeben, gibt dieser Parameter an, dass die zurückgegebenen Endpunkte an einer Zuordnung mit dem Quellobjekt teilnehmen müssen, in dem das Quellobjekt eine bestimmte Rolle spielt. Die Rolle wird durch den Namen einer angegebenen Eigenschaft (die eine Referenzeigenschaft sein muss) einer Zuordnung definiert.

bClassesOnly [in, optional]

Boolescher Wert, der angibt, ob eine Liste von Klassennamen anstelle tatsächlicher Instanzen der Klassen 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 nicht auf die Daten angewendet wird. Der Standardwert für diesen Parameter ist FALSE. Es kann nur auf TRUE festgelegt werden, wenn das Objekt, auf dem diese Methode aufgerufen wird, eine Klasse ist. Beim Festlegen auf TRUE stellen die zurückgegebenen Endpunkte Klassen dar, die der Quellklasse im Schema entsprechend zugeordnet sind.

strRequiredAssocQualifier [in, optional]

Zeichenfolge, die einen Qualifizierernamen enthält. Dieser Parameter, wenn angegeben, 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]

Zeichenfolge, die einen Qualifizierernamen enthält. Dieser Parameter, wenn angegeben, gibt an, dass die zurückgegebenen Endpunkte den angegebenen Qualifizierer enthalten müssen.

iFlags [in, optional]

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

wbemFlagForwardOnly (32 (0x20))

Führt dazu, dass ein Nur-Aufzählungszeichen zurückgegeben wird. Forward-only-Enumeratoren sind in der Regel viel schneller und verwenden weniger Arbeitsspeicher als herkömmliche Aufzählungen, aber sie ermöglichen keine Aufrufe SWbemObject.Clone_.

wbemFlagBidirectional (0 (0x0))

Führt dazu, dass WMI Zeiger auf Objekte der Aufzählung beibehalten, bis der Client den Aufzählungspunkt veröffentlicht.

wbemFlagReturnImmediately (16 (0x10))

Bewirkt, dass der Aufruf sofort zurückgegeben wird.

wbemFlagReturnWhenComplete (0 (0x0))

Führt dazu, dass dieser Aufruf blockiert wird, bis die Abfrage abgeschlossen ist.

wbemFlagUseAmendedQualifiers (131072 (0x20000))

Führt dazu, dass WMI Klassenänderungsdaten mit der Basisklassendefinition zurückzugeben. Einschließlich dieses Flags stellt den lokalisierten Beschreibungstext für Klassen, Eigenschaften und Methoden zur Verfügung. Weitere Informationen zu geänderten Qualifizierern finden Sie unter Localizing WMI Class Information.

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

Fehlercodes

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

wbemErrAccessDenied - 2147749891 (0x80041003)

Der aktuelle Benutzer hat keine Berechtigung, eine oder mehrere der von dem Aufruf zurückgegebenen Klassen anzuzeigen.

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 zur ASSOCIATORS OF associated WQL-Abfrage, Quellinstanzen und Endpunkten 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_SWbemObject
IID
IID_ISWbemObject

Siehe auch

Swbemobject

SWbemObject.References_

SWbemServices.AssociatorsOf

SWbemServices.ReferencesTo