Événement ISWbemSinkEvents::OnProgress

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

Pour obtenir une explication de cette syntaxe, voir 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 actuel en cours de traitement.

strMessage

Message qui décrit la statut de la tâche actuelle.

objWbemAsyncContext

Objet SWbemNamedValueSet 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 retournée

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)

La mémoire disponible est insuffisante pour terminer cette 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 le statut d’un appel en cours. Si les événements, les instances ou les classes sont produits par un fournisseur qui prend en charge les mises à jour de statut, vous pouvez placer du code dans cet événement pour fournir aux utilisateurs des commentaires sur le statut d'une opération asynchrone.

Spécifications

Voir aussi

SWbemSink