SWbemServices.GetAsync-Methode

Die GetAsync-Methode des SWbemServices-Objekts ruft basierend auf dem Objektpfad ein Objekt ab, bei dem es sich um eine Klassendefinition oder um eine Instanz handelt.

Diese Methode ruft nur Objekte aus dem Namespace ab, der dem aktuellen SWbemServices-Objekt zugeordnet ist.

Diese 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.GetAsync( _
  ByVal objWbemSink, _
  [ ByVal strObjectPath ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Parameter

objWbemSink

Erforderlich. Objektsenke, die Objekte asynchron abruft. Erstellen Sie ein SWbemSink-Objekt, um die Objekte zu empfangen.

strObjectPath [optional]

Pfad des Objekts, das Sie abrufen möchten. Wenn dieser Wert leer ist, kann das zurückgegebene leere Objekt eine neue Klasse werden. Weitere Informationen finden Sie unter Beschreiben des Speicherorts eines WMI-Objekts.

iFlags [optional]

Eine ganze Zahl, die das Verhalten des Aufrufs bestimmt. 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 mit der Basisklassendefinition zurückgibt. Weitere Informationen finden Sie unter Lokalisieren von WMI-Klasseninformationen.

objwbemNamedValueSet [optional]

In der Regel ist dieser Wert 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, wenn das Objekt verfügbar ist.

Fehlercodes

Nach Abschluss der GetAsync-Methode enthält das Err-Objekt möglicherweise einen der Fehlercodes aus der folgenden Liste:

wbemErrAccessDenied – 2147749891 (0x80041003)

Der aktuelle Benutzer bzw. die aktuelle Benutzerin ist nicht berechtigt, auf das Objekt zuzugreifen.

wbemErrFailed – 2147749889 (0x80041001)

Unbekannter Fehler.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Ein angegebener Parameter ist ungültig.

wbemErrInvalidObjectPath – 2147749946 (0x8004103A)

Der angegebene Pfad war ungültig.

wbemErrNotFound – 2147749890 (0x80041002)

Das angeforderte Objekt wurde nicht gefunden.

wbemErrOutOfMemory – 2147749894 (0x80041006)

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

Bemerkungen

Dieser Aufruf wird sofort abgeschlossen. Das angeforderte Objekt und der Status werden durch einen Rückruf an die Senke, die in objWbemSink angegeben ist, an die aufrufende Funktion zurückgegeben. Erstellen Sie eine Ereignisunterroutine vom Typ objWbemSink.OnObjectReady oder objWbemSink.OnCompleted, um das Objekt bei der Rückgabe zu verarbeiten.

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. Verwenden Sie eine halbsynchrone oder synchrone Kommunikation, um die Risiken zu beseitigen. Weitere Informationen finden Sie unter Festlegen der Sicherheit für einen asynchronen Aufruf.

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_SWbemServices
IID	IID_ISWbemServices

Weitere Informationen

SWbemServices

SWbemObject