É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.

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 applications. Pour éliminer les risques, utilisez la communication semi-synchrone ou synchrone. Pour plus d’informations, voir Appeler 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
IDL	Wbemdisp.idl
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemSink
IID	IID_ISWbemSinkEvents

Voir aussi

SWbemSink