SWbemObject.AssociatorsAsync_-Methode

Die AssociatorsAsync\_-Methode von SWbemObject ruft Objekte (Klassen oder Instanzen) ab, die dem aktuellen Objekt zugeordnet sind. Diese 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

SWbemObject.AssociatorsAsync_( _
  ByVal objWbemSink, _
  [ ByVal strAssocClass ], _
  [ ByVal strResultClass ], _
  [ ByVal strResultRole ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredAssocQualifier ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Parameter

objWbemSink [in]

Erforderlich. Objektsenke, die die Objekte asynchron als Rückruf empfängt.

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]

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. Dieser Parameter kann die folgenden Werte annehmen.

wbemFlagSendStatus (128 (0x80))

Bewirkt, dass asynchrone Aufrufe Statusupdates an den SWbemSink.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 die lokalisierten Klassen- und Eigenschaftsbeschreibungen zurückgibt. Weitere Informationen 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.

objWbemAsyncContext [in, optional]

Dies ist 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 mithilfe 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 der AssociatorsAsync_-Methode enthält das Err-Objekt 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 – 2147449889 (0x7FFF7C21)

Unbekannter Fehler.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Ein angegebener Parameter ist ungültig.

wbemErrOutOfMemory – 2147749894 (0x80041006)

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

Bemerkungen

Dieser Aufruf gibt sofort eine Antwort zurück. Die angeforderten Objekte und Status werden durch Rückrufe an die Senke, die in objWbemSink angegeben ist, an die aufrufende Funktion zurückgegeben. Erstellen Sie eine objWbemSink.OnObjectReady-Ereignisunterroutine, um jedes Objekt beim Eintreffen 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. Um die Risiken zu vermeiden, verwenden Sie entweder semisynchrone Kommunikation oder synchrone Kommunikation. Weitere Informationen finden Sie unter Aufrufen einer Methode.

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

Siehe auch

SWbemObject

SWbemServices.AssociatorsOfAsync

SWbemObject.References_

SWbemServices.ReferencesTo