Freigeben über


ISWbemSinkEvents::OnProgress-Ereignis

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