Méthode ISWbemSink::Cancel
La méthode Cancel de l’objet SWbemSink annule toutes les opérations asynchrones en cours associées à ce récepteur d’objets.
Pour obtenir 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 retournée
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)
-
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.
-
wbemErrAccessDenied - 2147749891 (0x80041003)
-
Le nom d’utilisateur et le mot de passe actuels ou spécifiés n’étaient pas valides ou autorisés à créer la connexion.
Notes
Vous ne pouvez pas annuler un seul appel asynchrone. Si plusieurs appels asynchrones qui utilisent ce récepteur d’objets sont en attente, cette méthode annule tous les appels asynchrones utilisant 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 affecter ce récepteur à Nothing pour annuler une opération asynchrone. Vous devez appeler la méthode Cancel pour que WMI arrête l’opération et libère les ressources associées. Cela est très important pour 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 applications. Pour éliminer les risques, utilisez la communication semi-synchrone ou synchrone. Pour plus d’informations, consultez Appeler une méthode.
L’exemple suivant vous 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 |
|
| IDL |
|
| DLL |
|
| CLSID |
CLSID_SWbemSink |
| IID |
IID_ISWbemSink |