ÉVÉNEMENT ISWbemSinkEvents::OnCompleted

L’événement OnCompleted d’un objet SWbemSink est déclenché lorsqu’un appel asynchrone est terminé. Cet événement indique à l’application cliente le résultat d’une opération asynchrone et fournit des informations d’erreur lorsque l’appel asynchrone échoue.

Pour obtenir une explication de cette syntaxe, consultez Conventions de document pour l’API Scripting.

Syntaxe

SWbemSink.OnCompleted( _
  ByVal iHResult, _
  ByVal objWbemErrorObject, _
  ByVal objWbemAsyncContext _
)

Paramètres

iHResult

HRESULT de la méthode asynchrone terminée. HRESULT est identique à la valeur retournée à partir d’un appel de méthode WMI d’API COM équivalent. Vérifiez cette valeur pour déterminer si l’appel asynchrone a réussi ou non. Si l’appel asynchrone réussit, ce paramètre contient WBEM_S_NO_ERROR (0). Si l’appel asynchrone échoue, ce paramètre contient un code d’erreur.

objWbemErrorObject

Contient un objet SWbemLastError en cas d’échec de la méthode asynchrone.

objWbemAsyncContext

Un 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ènementOnCompleted terminée, 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 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