Événement ISWbemSinkEvents :: OnObjectReady
L’événement OnObjectReady d’un objet SWbemSink est déclenché lorsqu’une opération asynchrone retourne un objet. Utilisez cet événement pour traiter des objets à partir d’appels asynchrones tels que SWbemObject. InstancesAsync _ ou SWbemServices.ExecQueryAsync. OnObjectReady retourne un SWbemObject chaque fois que l’énumération est terminée.
Pour une explication de cette syntaxe, consultez conventions de document pour l’API de script.
Syntaxe
SWbemSink.OnObjectReady( _
ByVal objWbemObject, _
ByVal objWbemAsyncContext _
)
Paramètres
-
objWbemObject
-
Objet SWbemObject . Cela est similaire à ce qui est retourné par l’équivalent synchrone de l’appel asynchrone qui déclenche cet événement. Par exemple, un appel à la méthode SWbemServices. GetAsync renvoie un SWbemObject dans le paramètre objWbemObject de l’événement OnObjectReady de l’objet SWbemSink , qui est passé comme paramètre objWbemObject de l’appel d’origine. Le même objet SWbemObject peut être obtenu à l’aide d’un appel synchrone équivalent à SWbemServices. obtenir.
-
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 retournée
Cet événement ne retourne pas de valeur.
Codes d’erreur
Une fois l’événement OnObjectReady 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
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 une communication synchrone. Pour plus d’informations, consultez appel d’une méthode.
Configuration requise
| 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 |