SWbemObject. DeleteAsync, _ méthode
La méthode _ DeleteAsync de SWbemObject supprime de manière asynchrone la classe actuelle ou l’instance actuelle. Si un fournisseur dynamique fournit la classe ou l’instance, il n’est pas toujours possible de supprimer cet objet, sauf si le fournisseur prend en charge la suppression de classe ou d’instance.
Pour une explication de cette syntaxe, consultez conventions de document pour l’API de script.
Syntaxe
SWbemObject.DeleteAsync_( _
ByVal objWbemSink, _
[ ByVal iFlags ], _
[ ByVal objwbemNamedValueSet ], _
[ ByVal objWbemAsyncContext ] _
)
Paramètres
-
objWbemSink [ dans]
-
Récepteur d’objets qui retourne le résultat de l’opération de suppression.
-
IFlags [ dans, facultatif]
-
Entier qui détermine le comportement de l’appel. Ce paramètre peut accepter les valeurs suivantes.
-
wbemFlagSendStatus * * * * (128 (0x80))
-
Fait en sorte que les appels asynchrones envoient des mises à jour d’État au gestionnaire d’événements SWbemSink. OnProgress pour le récepteur d’objets.
-
wbemFlagDontSendStatus * * * * (0 (0x0))
-
Empêche les appels asynchrones d’envoyer des mises à jour d’État au gestionnaire d’événements OnProgress pour le récepteur d’objets.
objwbemNamedValueSet [ dans, facultatif]
Ce paramètre n’est généralement pas défini. Dans le cas contraire, il s’agit d’un objet SWbemNamedValueSet dont les éléments représentent les informations de contexte qui peuvent être utilisées par le fournisseur qui traite la requête. Un fournisseur qui prend en charge ou requiert ces informations doit documenter les noms de valeur reconnus, le type de données de la valeur, les valeurs autorisées et la sémantique.
objWbemAsyncContext [ dans, facultatif]
Il s’agit d’un objet SWbemNamedValueSet qui retourne au récepteur d’objets pour identifier la source de l’appel asynchrone d’origine. Utilisez ce paramètre si vous effectuez plusieurs appels asynchrones à l’aide du même récepteur d’objets. Pour utiliser ce paramètre, créez un objet SWbemNamedValueSet et utilisez la méthode SWbemNamedValueSet. Add pour ajouter une valeur qui identifie l’appel asynchrone que vous effectuez. Cet objet SWbemNamedValueSet est retourné au récepteur d’objets et la source de l’appel peut être extraite à l’aide de la méthode SWbemNamedValueSet. Item . Pour plus d’informations, consultez appel d’une méthode.
Valeur retournée
Cette méthode ne retourne pas de valeur. Si cet appel réussit, le résultat de l’opération de suppression est fourni par le biais du récepteur d’objets fourni.
Codes d’erreur
À la fin de la méthode _ DeleteAsync , l’objet Err peut contenir l’un des codes d’erreur répertoriés dans la liste suivante.
-
wbemErrAccessDenied -2147749891 (0x80041003)
-
Le contexte actuel ne dispose pas des droits de sécurité adéquats pour supprimer l’objet.
-
wbemErrFailed -2147749890 (0x80041002)
-
Erreur non spécifiée.
-
wbemErrInvalidClass -2147749904 (0x80041010)
-
La classe spécifiée n’existe pas.
-
wbemErrInvalidOperation -2147749910 (0x80041016)
-
Impossible de supprimer l’objet.
-
wbemErrNotFound -2147749890 (0x80041002)
-
L’objet n’existait pas.
-
wbemErrOutOfMemory -2147749894 (0x80041006)
-
Mémoire insuffisante pour terminer l’opération.
Remarques
Cet appel est retourné immédiatement. L’État est retourné à l’appelant via un rappel remis au récepteur spécifié dans objWbemSink.
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 une communication synchrone. Pour plus d’informations, consultez appel d’une méthode.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista |
| Serveur minimal pris en charge |
Windows Server 2008 |
| En-tête |
|
| Bibliothèque de types |
|
| DLL |
|
| CLSID |
CLSID _ SWbemObject |
| IID |
IID _ ISWbemObject |