SWbemServices.AssociatorsOfAsync-Methode
Die AssociatorsOfAsync-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. Der Aufruf von AssociatorsOfAsync gibt sofort eine Antwort zurück, und die Ergebnisse und Status werden durch Ereignisse an die aufrufende Funktion zurückgegeben, die an die in objWbemSink angegebene Senke übermittelt werden. Zur Verarbeitung der einzelnen zurückgegebenen Objekte erstellen Sie einen objWbemSink.OnObjectReady-Ereignishandler.
Nachdem alle Objekte eingetroffen sind, erfolgt die Verarbeitung im objWbemSink.OnCompleted-Ereignis. Diese Methode führt dieselbe Funktion aus wie die WQL-Abfrage „ASSOCIATORS OF“. Weitere Informationen zum Erstellen einer Senke finden Sie unter Empfangen eines WMI-Ereignisses.
Die Methode wird im asynchronen 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
SWbemServices.AssociatorsOfAsync( _
ByVal objWbemSink, _
ByVal strObjectPath, _
[ ByVal strAssocClass ], _
[ ByVal strResultClass ], _
[ ByVal strResultRole ], _
[ ByVal strRole ], _
[ ByVal bClassesOnly ], _
[ ByVal bSchemaOnly ], _
[ ByVal strRequiredAssocQualifier ], _
[ ByVal strRequiredQualifier ], _
[ ByVal iFlags ], _
[ ByVal objWbemNamedValueSet ], _
[ ByVal objWbemAsyncContext ] _
)
Parameter
-
objWbemSink
-
Erforderlich. Objektsenke, die die Objekte asynchron empfängt. Erstellen Sie ein SWbemSink-Objekt, um die Objekte zu empfangen.
-
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 dieser Parameter angegeben ist, weist er darauf hin, dass die zurückgegebenen Endpunkte der Quelle über die angegebene Assoziationsklasse 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 wbemFlagDontSendStatus. Dieser Parameter kann die folgenden Werte akzeptieren.
-
wbemFlagSendStatus (128 (0x80))
-
Bewirkt, dass asynchrone Aufrufe Statusupdates an den OnProgress-Ereignishandler für die Objektsenke senden.
-
wbemFlagDontSendStatus (0 (0x0))
-
Verhindert, dass asynchrone Aufrufe Statusupdates an den OnProgress-Ereignishandler für die Objektsenke senden.
-
wbemFlagUseAmendedQualifiers (131072 (0x20000))
-
Bewirkt, dass WMI Klassenänderungsdaten zusammen mit der Basisklassendefinition zurückgibt. Weitere Informationen zu geänderten Qualifizierern finden Sie unter Lokalisieren von WMI-Klasseninformationen.
objWbemNamedValueSet [optional]
Dies ist 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.
objWbemAsyncContext [optional]
Ein SWbemNamedValueSet-Objekt, das an die Objektsenke zurückgegeben wird, um die Quelle des ursprünglichen asynchronen Aufrufs zu identifizieren. Verwenden Sie diesen Parameter, wenn Sie mehrere asynchrone Aufrufe mit derselben Objektsenke ausführen. Zur Verwendung dieses Parameters erstellen Sie ein SWbemNamedValueSet-Objekt und verwenden die SWbemNamedValueSet.Add-Methode, um einen Wert hinzuzufügen, der den asynchronen Aufruf identifiziert, den Sie ausführen. Dieses SWbemNamedValueSet-Objekt wird an die Objektsenke zurückgegeben, und die Quelle des Aufrufs kann mithilfe der SWbemNamedValueSet.Item-Methode extrahiert werden. Weitere Informationen finden Sie unter Aufrufen einer Methode.
Rückgabewert
Diese Methode gibt keinen Wert zurück. Bei erfolgreicher Ausführung empfängt die Senke ein OnObjectReady-Ereignis pro Instanz. Nach der letzten Instanz empfängt die Objektsenke ein OnCompleted-Ereignis.
Fehlercodes
Nach Abschluss derAssociatorsOfAsync-Methode enthält das Err-Objekt möglicherweise einen der Fehlercodes in der folgenden Liste.
-
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
Dieser Aufruf wird sofort zurückgegeben. Die angeforderten Objekte und Status werden durch Rückrufe an die aufrufende Funktion zurückgegeben, die an die in objWbemSink angegebene Senke übermittelt werden. Erstellen Sie eine objWbemSink.OnObjectReady-Ereignisunterroutine, um jedes Objekt bei der Rückgabe zu verarbeiten. Nachdem alle Objekte zurückgegeben wurden, können Sie die endgültige Verarbeitung in Ihrer Implementierung des objWbemSink.OnCompleted-Ereignisses durchführen.
Ein asynchroner Rückruf ermöglicht es nicht authentifizierten Benutzer*innen, Daten für die Senke bereitzustellen. Dies stellt Sicherheitsrisiken für Ihre Skripts und Anwendungen dar. Informationen zur Vermeidung dieser Risiken finden Sie unter Festlegen der Sicherheit für einen asynchronen Aufruf.
Verwenden Sie den objWbemAsyncContext-Parameter in Skripts, um die Quelle eines Aufrufs zu überprüfen.
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 |