É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 |
|
IDL |
|
DLL |
|
CLSID |
CLSID_SWbemSink |
IID |
IID_ISWbemSinkEvents |