SWbemServices.DeleteAsync, méthode

Article
06/29/2023

La méthode DeleteAsync de l’objet SWbemServices supprime la classe ou l’instance spécifiée dans le chemin de l’objet. L’appel à DeleteAsync est retourné immédiatement. Les résultats et l’état sont retournés à l’appelant via des événements remis au récepteur spécifié dans objWbemSink. Pour plus d’informations sur la création d’un récepteur, consultez Réception d’un événement WMI. Vous pouvez uniquement supprimer des objets de l’espace de noms auquel vous êtes connecté.

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.

La méthode est appelée en mode asynchrone. Pour plus d’informations, consultez Appel d’une méthode.

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

Syntaxe

SWbemServices.DeleteAsync( _
  [ ByVal ObjWbemSink ], _
  ByVal strObjectPath, _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Paramètres

ObjWbemSink [facultatif]: Récepteur d’objets qui reçoit les résultats de la suppression. Créez un objet SWbemSink pour recevoir les objets.
strObjectPath: Obligatoire. Chaîne qui contient le chemin d’accès de l’objet à supprimer. Pour plus d’informations, consultez Description de l’emplacement d’un objet WMI.
iFlags [facultatif]: Détermine si les mises à jour d’état sont retournées. Ce paramètre peut accepter les valeurs suivantes.
wbemFlagSendStatus (128 (0x80)): Provoque des appels asynchrones pour envoyer des mises à jour de l’état du récepteur d’objets au gestionnaire d’événements OnProgress.
wbemFlagDontSendStatus (0 (0x0)): Empêche les appels asynchrones d’envoyer des mises à jour d’état au gestionnaire d’événements OnProgress du récepteur d’objets.

objWbemNamedValueSet [facultatif]

En règle générale, ceci n’est 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 [facultatif]

Objet SWbemNamedValueSet qui est retourné 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 l’appel réussit, le récepteur d’objets reçoit une notification de la suppression.

Codes d’erreur

Une fois la méthode DeleteAsync exécutée, l’objet Err peut contenir l’un des codes d’erreur de la liste suivante.

wbemErrFailed - 2147749889 (0x80041001): Erreur non spécifiée.
wbemErrInvalidParameter - 2147749896 (0x80041008): Un paramètre non valide a été spécifié.
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, ne sont pas valides ou ne sont pas autorisés à établir la connexion.
wbemErrNotFound - 2147749890 (0x80041002): L’élément demandé est introuvable.

Notes

Cet appel est retourné immédiatement. L’état de l’opération de suppression est retourné à l’appelant via un rappel remis au récepteur spécifié dans objWbemSink. Vous pouvez effectuer le traitement final dans votre implémentation de l’événement objWbemSink.OnCompleted.

Un rappel asynchrone permet à un utilisateur non authentifié de fournir des données au récepteur. Cela présente des risques quant à la sécurité de vos scripts et applications. Pour éliminer ces risques, consultez Configuration de la sécurité sur un appel asynchrone.

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_SWbemServices
IID	IID_ISWbemServices

Voir aussi

SWbemServices
SWbemObjectPath

Partager via