SWbemServices.AssociatorsOf-Methode
Die AssociatorsOf-Methode des SWbemServices-Objekts gibt eine Auflistung von Objekten (Klassen oder Instanzen) zurück, die als Endpunkte bezeichnet werden und einem angegebenen Objekt zugeordnet sind. Diese Methode führt dieselbe Funktion wie die WQL-Abfrage „ASSOCIATORS OF“ aus.
Diese Methode wird standardmäßig im semisynchronen Modus aufgerufen. Weitere Informationen finden Sie unter Aufrufen einer Methode.
Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skript-API.
Syntax
objWbemObjectSet = .AssociatorsOf( _
ByVal strObjectPath, _
[ ByVal strAssocClass ], _
[ ByVal strResultClass ], _
[ ByVal strResultRole ], _
[ ByVal strRole ], _
[ ByVal bClassesOnly ], _
[ ByVal bSchemaOnly ], _
[ ByVal strRequiredAssocQualifier ], _
[ ByVal strRequiredQualifier ], _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ] _
)
Parameter
-
strObjectPath
-
Erforderlich. Eine Zeichenfolge, die den Objektpfad der Quellklasse oder -instanz enthält. Weitere Informationen finden Sie unter Beschreiben des Speicherorts eines WMI-Objekts.
-
strAssocClass [optional]
-
Eine Zeichenfolge, die eine Zuordnungsklasse enthält. 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 [optional]
-
Eine Zeichenfolge, die einen Klassennamen enthält. Wenn dieser optionale Parameter angegeben ist, weist er darauf hin, dass die zurückgegebenen Endpunkte zu der im Parameter angegebenen Klasse gehören oder von ihr abgeleitet sein müssen.
-
strResultRole [optional]
-
Eine Zeichenfolge, die einen Eigenschaftsnamen enthält. 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 [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 [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 [optional]
-
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 der strObjectPath-Parameter den Objektpfad einer Klasse angibt. Bei Festlegung auf TRUE stellt der Satz der zurückgegebenen Endpunkte Klassen dar, die der Quellklasse im Schema entsprechend zugeordnet sind.
-
strRequiredAssocQualifier [optional]
-
Eine Zeichenfolge, die einen Qualifizierernamen enthält. Wenn dieser Parameter angegeben ist, weist er darauf hin, dass die zurückgegebenen Endpunkte dem Quellobjekt über eine Assoziationsklasse zugeordnet werden müssen, die den angegebenen Qualifizierer enthält.
-
strRequiredQualifier [optional]
-
Eine Zeichenfolge, die einen Qualifizierernamen enthält. Wenn dieser Parameter angegeben ist, weist er darauf hin, dass die zurückgegebenen Endpunkte den angegebenen Qualifizierer enthalten müssen.
-
iFlags [optional]
-
Eine ganze Zahl, die zusätzliche Flags für den Vorgang angibt. Der Standardwert für diesen Parameter ist wbemFlagReturnImmediately, der die -Methode im semisynchronen Modus aufruft. 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. Dieses Flag ruft die Methode im synchronen Modus auf.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Bewirkt, dass WMI Klassenänderungsdaten zusammen mit der Basisklassendefinition zurückgibt. Weitere Informationen finden Sie unter Lokalisieren von WMI-Klasseninformationen.
objwbemNamedValueSet [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 derAssociatorsOf-Methode enthält das Err-Objekt möglicherweise einen der Fehlercodes in der folgenden Liste.
Hinweis
Eine zurückgegebene Sammlung mit null Elementen ist kein Fehler.
-
wbemErrAccessDenied – 2147749891 (0x80041003)
-
Der aktuelle Benutzer oder die aktuelle Benutzerin verfügt nicht über die Berechtigung zum Anzeigen einer oder mehrerer Klassen, die vom Aufruf zurückgegeben werden.
-
wbemErrFailed – 2147749889 (0x80041001)
-
Unbekannter Fehler.
-
wbemErrInvalidParameter – 2147749896 (0x80041008)
-
Es wurde ein ungültiger Parameter angegeben.
-
wbemErrOutOfMemory – 2147749894 (0x80041006)
-
Es ist nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs vorhanden.
-
wbemErrNotFound – 2147749890 (0x80041002)
-
Das angeforderte Element wurde nicht gefunden.
Bemerkungen
Die Methode ruft die Instanzen verwalteter Ressourcen ab, die einer angegebenen Ressource über eine oder mehrere Zuordnungsklassen zugeordnet sind. Sie geben den Objektpfad für den ursprünglichen Endpunkt an, und AssociatorsOf gibt die verwalteten Ressourcen am entgegengesetzten Endpunkt zurück. Die AssociatorsOf-Methode führt dieselbe Funktion wie die WQL-Abfrage „ASSOCIATORS OF“ aus.
Weitere Informationen zur WQL-Abfrage „ASSOCIATORS OF“, zu 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 |
|
| Typbibliothek |
|
| DLL |
|
| CLSID |
CLSID_SWbemServices |
| IID |
IID_ISWbemServices |