SWbemObject.DeleteAsync_ method

Article
06/29/2023

La méthode DeleteAsync_ de SWbemObject supprime de façon asynchrone la classe actuelle ou l’instance actuelle. Si un fournisseur dynamique fournit la classe ou l’instance, il n’est parfois pas possible de supprimer cet objet, sauf si le fournisseur prend en charge la suppression de classe ou d’instance.

Pour obtenir une explication de cette syntaxe, consultez Conventions de document pour l’API Scripting.

Syntaxe

SWbemObject.DeleteAsync_( _
  ByVal objWbemSink, _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Paramètres

objWbemSink [in]: Récepteur d’objets qui retourne le résultat de l’opération de suppression.
iFlags [in, facultatif]: Entier qui détermine le comportement de l’appel. Ce paramètre peut accepter les valeurs suivantes.
wbemFlagSendStatus (128 (0x80)): Provoque des appels asynchrones pour envoyer 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 [in, facultatif]

Ce paramètre n’est généralement pas défini. Sinon, 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 répondant à la demande. Un fournisseur qui prend en charge ou requiert de telles 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 [in, optional]

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 de l’objet, 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 via le récepteur d’objets fourni.

Codes d’erreur

Une fois la méthode DeleteAsync_ terminée, l’objet Err peut contenir l’un des codes d’erreur de 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): L’objet ne peut pas être supprimé.
wbemErrNotFound - 2147749890 (0x80041002): L’objet n’existait pas.
wbemErrOutOfMemory - 2147749894 (0x80041006): La mémoire disponible est insuffisante pour terminer cette opération.

Notes

Cet appel est retourné immédiatement. L’état est retourné à l’appelant par le biais d’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 applications. Pour éliminer les risques, utilisez la communication semi-synchronisée ou la communication 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	Wbemdisp.h
Bibliothèque de types	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

Partager via