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 |
|
| MIDL |
|
| DLL |
|
| CLSID |
CLSID _ SWbemSink |
| IID |
IID _ ISWbemSinkEvents |