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 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 Skripterstellungs-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]
-
Der 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ück gibt. Weitere Informationen finden Sie unter Lokalisieren von WMI-Klasseninformationen.
objwbemNamedValueSet [ Optional]
In der Regel ist dieser Wert nicht definiert. Andernfalls ist dies ein SWbemNamedValueSet-Objekt, dessen Elemente die Kontextinformationen darstellen, die vom Anbieter verwendet werden können, der die Anforderung bedient. Ein Anbieter, der solche Informationen unterstützt oder erfordert, muss die erkannten Wertnamen, den Datentyp des Werts, die zulässigen Werte und die Semantik dokumentieren.
objWbemAsyncContext [ Optional]
Ein SWbemNamedValueSet-Objekt, das zur Objektsenke zurückkehrt, um die Quelle des ursprünglichen asynchronen Aufrufs zu identifizieren. Verwenden Sie diesen Parameter, wenn Sie mehrere asynchrone Aufrufe mit derselben Objektsenke ausführen. Um diesen Parameter zu verwenden, erstellen Sie ein SWbemNamedValueSet-Objekt, und verwenden Sie die SWbemNamedValueSet.Add-Methode, um einen Wert hinzuzufügen, der den von Ihnen ausgeführten asynchronen Aufruf identifiziert. 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 Erfolg empfängt die Senke ein OnObjectReady-Ereignis, wenn das Objekt verfügbar ist.
Fehlercodes
Nach Abschluss der GetAsync-Methode kann das Err-Objekt einen der Fehlercodes in der folgenden Liste enthalten.
-
wbemErrAccessDenied – 2147749891 (0x80041003)
-
Der aktuelle Benutzer verfügt nicht über die Berechtigung für den Zugriff auf das Objekt.
-
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)
-
Nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs.
Hinweise
Dieser Aufruf wird sofort zurückgegeben. Das angeforderte Objekt und der Status werden an den Aufrufer über einen Rückruf zurückgegeben, der an die in objWbemSink angegebene Senke übermittelt wird. Um das -Objekt nach der Rückgabe zu verarbeiten, erstellen Sie ein objWbemSink -Objekt. OnObjectReadyoder objWbemSink. OnCompleted-Ereignisunterroutine.
Ein asynchroner Rückruf ermöglicht es einem nicht authentifizierten Benutzer, Daten für die Senke zur Verfügung zu stellen. Dies birgt Sicherheitsrisiken für Ihre Skripts und Anwendungen. Um die Risiken zu beseitigen, verwenden Sie die semisynchrone oder synchrone Kommunikation. Weitere Informationen finden Sie unter Festlegen der Sicherheit für einen asynchronen Aufrufvon .
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 |