SWbemObject.ReferencesAsync_ Methode

Die ReferencesAsync_ -Methode von SWbemObject stellt eine Auflistung aller Zuordnungsklassen oder Instanzen bereit, die auf das aktuelle Objekt verweisen. Diese Methode führt dieselbe Funktion aus, die die WQL-VERWEISE VON-Abfrage ausführt.

Eine Erläuterung dieser Syntax finden Sie unter Dokumentkonventionen für die Skripting-API.

Syntax

SWbemObject.ReferencesAsync_( _
  ByVal objWbemSink, _
  [ ByVal strResultClass ], _
  [ ByVal strRole ], _
  [ ByVal bClassesOnly ], _
  [ ByVal bSchemaOnly ], _
  [ ByVal strRequiredQualifier ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Parameter

objWbemSink [in]

Erforderlich. Objekt sinken, die die Objekte asynchron empfängt.

strResultClass [in, optional]

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

strRole [in, optional]

Zeichenfolge, die einen Eigenschaftennamen enthält. Wenn angegeben, gibt dieser Parameter an, dass die zurückgegebenen Zuordnungsobjekte auf diejenigen beschränkt sein müssen, in denen das Quellobjekt eine bestimmte Rolle spielt. Der Name einer angegebenen Referenzeigenschaft definiert die Rolle einer Zuordnung.

bClassesOnly [in, optional]

Boolescher Wert, der angibt, ob eine Liste von Klassennamen statt tatsächlicher Instanzen der Klassen zurückgegeben werden soll. Dies sind die Klassen, zu denen die Zuordnungsobjekte gehören. Der Standardwert für diesen Parameter ist FALSE.

bSchemaOnly [in, optional]

Boolescher Wert, der angibt, ob die Abfrage anstelle der Daten auf das Schema 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 stellt der Satz zurückgegebener Endpunkte Klassen dar, die der Quellklasse im Schema entsprechend zugeordnet sind.

strRequiredQualifier [in, optional]

Zeichenfolge, die einen Qualifizierernamen enthält. Wenn angegeben, gibt dieser Parameter an, dass die zurückgegebenen Zuordnungsobjekte den angegebenen Qualifizierer enthalten müssen.

iFlags [in, optional]

Ganzzahl, die zusätzliche Flags für den Vorgang angibt. Dieser Parameter kann die folgenden Werte akzeptieren.

wbemFlagSendStatus (128 (0x80))

Verursacht asynchrone Aufrufe zum Senden von Statusupdates an den SWbemSink.OnProgress-Ereignishandler für das Objekt sinken.

wbemFlagDontSendStatus (0 (0x0))

Verhindert, dass asynchrone Aufrufe statusupdates an den OnProgress-Ereignishandler für das Objekt sinken.

wbemFlagUseAmendedQualifiers (131072 (0x20000))

Verursacht, dass Windows Verwaltungsinstrumentation (WMI) Klassenänderungsdaten mit der Basisklassendefinition zurückgeben. Weitere Informationen 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.

objWbemAsyncContext [in, optional]

Dies ist ein SWbemNamedValueSet-Objekt , das zum Objektsenken zurückgibt, um die Quelle des ursprünglichen asynchronen Aufrufs zu identifizieren. Verwenden Sie diesen Parameter, wenn Sie mehrere asynchrone Aufrufe mit demselben Objekt sinken. Um diesen Parameter zu verwenden, erstellen Sie ein SWbemNamedValueSet-Objekt, und verwenden Sie die SWbemNamedValueSet.Add-Methode , um einen Wert hinzuzufügen, der den asynchronen Aufruf identifiziert, den Sie vornehmen. Dieses SWbemNamedValueSet-Objekt wird an das Objekt sinken 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 das Sinken ein OnObjectReady-Ereignis pro Instanz. Nach der letzten Instanz empfängt das Objekt sinken ein OnCompleted-Ereignis .

Fehlercodes

Nach Abschluss der ReferencesAsync_ -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)

Ungültiger Parameter wurde angegeben.

wbemErrOutOfMemory - 2147749894 (0x80041006)

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

Bemerkungen

Dieser Aufruf wird sofort zurückgegeben. Die angeforderten Objekte und der Status werden über Rückrufe an den Aufrufer zurückgegeben, die an die Leiste übermittelt werden, die in objWbemSink angegeben ist. Um jedes Objekt zu verarbeiten, wenn es ankommt, erstellen Sie einen objWbemSink. OnObjectReady-Ereignisunterroutine . Nachdem alle Objekte zurückgegeben werden, können Sie die endgültige Verarbeitung in Ihrer Implementierung des objWbemSink ausführen. OnCompleted-Ereignis .

Ein asynchroner Rückruf ermöglicht einem nicht authentifizierten Benutzer die Bereitstellung von Daten an das Sinken. Dies stellt Sicherheitsrisiken für Ihre Skripts und Anwendungen dar. Um die Risiken zu beseitigen, verwenden Sie entweder semisynchrone Kommunikation oder synchrone Kommunikation. Weitere Informationen finden Sie unter Aufrufen einer Methode.

Weitere Informationen zu den VERWEISE DER zugeordneten WQL-Abfrage, Quellinstanzen und Zuordnungsobjekte 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.Associators_

SWbemServices.AssociatorsOf

SWbemServices.ReferencesTo

SWbemServices.ReferencesToAsync