ISWbemSinkEvents :: OnProgress, événement

L’événement OnProgress de SWbemSink est déclenché lorsqu’un appel asynchrone retourne l’état d’un appel en cours. Si les événements, les instances ou les classes sont produits à partir d’un fournisseur qui prend en charge les mises à jour d’État, vous pouvez placer le code dans cet événement pour fournir aux utilisateurs des commentaires sur l’état d’une opération asynchrone. Vous devez définir le paramètre IFlags de l’appel asynchrone à wbemFlagSendStatus (128/0x80) si vous souhaitez recevoir des mises à jour d’État, sinon cet événement n’est pas déclenché.

Pour une explication de cette syntaxe, consultez conventions de document pour l’API de script.

Syntaxe

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

Paramètres

iUpperBound

Entier qui décrit le nombre total de tâches à effectuer.

iCurrent

Élément en cours de traitement.

strMessage

Message qui décrit l’état de la tâche en cours.

objWbemAsyncContext

Objet SWbemNamedValueSet qui est passé à l’appel asynchrone d’origine. Utilisez ce paramètre pour identifier l’origine de l’appel asynchrone qui déclenche cet événement lorsque plusieurs appels asynchrones sont effectués à l’aide de ce récepteur d’objets.

Valeur de retour

Cet événement ne retourne pas de valeur.

Codes d’erreur

Une fois l’événement OnProgress terminé, l’objet Err peut contenir l’un des codes d’erreur ci-dessous.

wbemErrFailed -2147749889 (0x80041001)

Erreur non spécifiée.

wbemErrOutOfMemory -2147749894 (0x80041006)

Mémoire insuffisante pour terminer l’opération.

wbemErrTransportFailure -2147749909 (0x80041015)

Une erreur réseau s’est produite, empêchant le fonctionnement normal.

Notes

L’événement OnProgress est déclenché lorsqu’un appel asynchrone retourne l’état d’un appel en cours. Si les événements, les instances ou les classes sont produits à partir d’un fournisseur qui prend en charge les mises à jour d’État, vous pouvez placer le code dans cet événement pour permettre aux utilisateurs de fournir des commentaires sur l’état d’une opération asynchrone.

Notes

Un rappel asynchrone permet à un utilisateur non authentifié de fournir des données au récepteur. Cela pose des risques de sécurité pour vos scripts et vos applications. Pour éliminer les risques, utilisez une communication semi-synchrone ou synchrone. Pour plus d’informations, consultez appel d’une méthode.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows Vista
Serveur minimal pris en charge
Windows Server 2008
En-tête
Wbemdisp. h
MIDL
Wbemdisp. idl
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemSink
IID
IID _ ISWbemSinkEvents

Voir aussi

SWbemSink