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
Wbemdisp. h
Bibliothèque de types
Wbemdisp. tlb
DLL
Wbemdisp.dll
CLSID
CLSID _ SWbemObject
IID
IID _ ISWbemObject