Événement ISWbemSinkEvents::OnObjectReady

Article
06/13/2023

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 provenant d’appels asynchrones tels que SWbemObject.InstancesAsync_ ou SWbemServices.ExecQueryAsync. OnObjectReady retourne un objet SWbemObject chaque fois jusqu’à ce que l’énumération soit terminée.

Pour obtenir 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 retourne un objetSWbemObject dans le paramètre objWbemObject de l’événementOnObjectReady de l’objet SWbemSink , qui est passé en tant que paramètre objWbemObject de l’appel d’origine. Le même objet SWbemObject peut être obtenu à l’aide d’un appel synchrone équivalent à SWbemServices.Get.
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 OnObjectPut 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

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 la communication 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
IDL	Wbemdisp.idl
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemSink
IID	IID_ISWbemSinkEvents

Voir aussi

SWbemSink