ISWbemSinkEvents::OnProgress-Ereignis

Artikel
06/29/2023

Das OnProgress-Ereignis von SWbemSink wird ausgelöst, wenn ein asynchroner Aufruf den Status eines Aufrufs zurückgibt, der gerade ausgeführt wird. Wenn die Ereignisse, Instanzen oder Klassen von einem Anbieter erzeugt werden, der Statusupdates unterstützt, können Sie Code in diesem Ereignis platzieren, um Benutzern Feedback zum Status eines asynchronen Vorgangs zu geben. Sie müssen den iFlags-Parameter des asynchronen Aufrufs auf wbemFlagSendStatus (128/0x80) festlegen, wenn Sie Statusupdates erhalten möchten. Andernfalls wird dieses Ereignis nicht ausgelöst.

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

Syntax

SWbemSink.OnProgress( _
  ByVal iUpperBound, _
  ByVal iCurrent, _
  ByVal strMessage, _
  ByVal objWbemAsyncContext _
)

Parameter

iUpperBound: Ganze Zahl, die die Gesamtzahl der auszuführenden Aufgaben angibt.
iCurrent: Aktuelles Element, das verarbeitet wird.
strMessage: Meldung, die den Status der aktuellen Aufgabe beschreibt.
objWbemAsyncContext: Ein Objekt SWbemNamedValueSet, das an den ursprünglichen asynchronen Aufruf übergeben wird. Verwenden Sie diesen Parameter, um den Ursprung des asynchronen Aufrufs zu identifizieren, der dieses Ereignis auslöst, wenn mehrere asynchrone Aufrufe mit dieser Objektsenke ausgeführt werden.

Rückgabewert

Dieses Ereignis gibt keinen Wert zurück.

Fehlercodes

Nach Abschluss des OnProgress-Ereignisses kann das Err-Objekt einen der folgenden Fehlercodes enthalten.

wbemErrFailed – 2147749889 (0x80041001): Unbekannter Fehler.
wbemErrOutOfMemory – 2147749894 (0x80041006): Es ist nicht genügend Arbeitsspeicher zum Abschließen des Vorgangs vorhanden.
wbemErrTransportFailure – 2147749909 (0x80041015): Netzwerkfehler, der den normalen Betrieb verhinderte.

Bemerkungen

Das OnProgress-Ereignis wird ausgelöst, wenn ein asynchroner Aufruf den Status eines Aufrufs zurückgibt, der gerade ausgeführt wird. Wenn die Ereignisse, Instanzen oder Klassen von einem Anbieter erzeugt werden, der Statusupdates unterstützt, können Sie Code in diesem Ereignis platzieren, um Benutzern Feedback zum Status eines asynchronen Vorgangs zu geben.

Hinweis

Ein asynchroner Rückruf ermöglicht es einem nicht authentifizierten Benutzer, Daten für die Senke bereitzustellen. Dies stellt Sicherheitsrisiken für Ihre Skripts und Anwendungen dar. Um die Risiken zu vermeiden, verwenden Sie semisynchrone oder synchrone Kommunikation. Weitere Informationen finden Sie unter Aufrufen einer Methode.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Header	Wbemdisp.h
IDL	Wbemdisp.idl
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemSink
IID	IID_ISWbemSinkEvents

Weitere Informationen

SWbemSink

Freigeben über