ISWbemSink :: Cancel, méthode

La méthode Cancel de l’objet SWbemSink annule toutes les opérations asynchrones en suspens associées à ce récepteur d’objets.

Pour une explication de cette syntaxe, consultez conventions de document pour l’API de script.

Syntaxe

SWbemSink.Cancel()

Paramètres

Cette méthode n’a aucun paramètre.

Valeur de retour

Cette méthode ne retourne pas de valeur.

Codes d’erreur

Une fois la méthode Cancel 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)

Mémoire insuffisante pour terminer l’opération.

wbemErrTransportFailure -2147749909 (0x80041015)

Une erreur réseau s’est produite, empêchant le fonctionnement normal.

wbemErrAccessDenied -2147749891 (0x80041003)

Le nom d’utilisateur et le mot de passe actuels ou spécifiés ne sont pas valides ou autorisés à établir la connexion.

Notes

Vous ne pouvez pas annuler un seul appel asynchrone. Si plusieurs appels asynchrones sont en attente qui utilisent ce récepteur d’objets, cette méthode annule tous les appels asynchrones à l’aide de ce récepteur d’objets. Les appels asynchrones associés à d’autres récepteurs d’objets ne sont pas affectés.

Vous ne pouvez pas assigner à ce récepteur la valeur Nothing pour annuler une opération asynchrone. Vous devez appeler la méthode Cancel pour que WMI interrompe l’opération et libère les ressources associées. Cela est très important avec les opérations asynchrones longues, telles que les requêtes, ou les opérations qui ne se terminent jamais, telles que ExecNotificationQueryAsync.

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.

L’exemple suivant montre comment annuler un appel asynchrone.

objwbemsink.Cancel()
set objwbemsink= Nothing

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
MIDL
Wbemdisp. idl
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemSink
IID
IID _ ISWbemSink

Voir aussi

SWbemSink