Méthode IWbemServices::D eleteClassAsync (wbemcli.h)

La méthode IWbemServices::D eleteClassAsync supprime la classe spécifiée de l’espace de noms actuel. Cette méthode est identique à IWbemServices::D eleteClass , sauf que l’appel est retourné immédiatement. La confirmation ou l’échec est signalé de manière asynchrone au récepteur d’objets spécifié à l’aide de la méthode IWbemObjectSink::SetStatus une fois l’opération terminée.

Syntaxe

HRESULT DeleteClassAsync(
  [in] const BSTR      strClass,
  [in] long            lFlags,
  [in] IWbemContext    *pCtx,
  [in] IWbemObjectSink *pResponseHandler
);

Paramètres

[in] strClass

Nom de la classe ciblée pour la suppression.

[in] lFlags

Une ou plusieurs des valeurs suivantes sont valides.

WBEM_FLAG_SEND_STATUS

Cet indicateur inscrit auprès de Windows Management une demande de réception de rapports status intermédiaires par le biais de l’implémentation par le client de IWbemObjectSink::SetStatus. L’implémentation du fournisseur doit prendre en charge les rapports intermédiaires status, pour que cet indicateur change le comportement.

WBEM_FLAG_OWNER_UPDATE

Les fournisseurs push doivent spécifier cet indicateur lors de l’appel de DeleteClassAsync pour indiquer que cette classe a changé.

[in] pCtx

Généralement NULL. Sinon, il s’agit d’un pointeur vers un objet IWbemContext qui peut être utilisé par le fournisseur qui supprime la classe . Les valeurs de l’objet de contexte doivent être spécifiées dans la documentation du fournisseur en question. Pour plus d’informations sur ce paramètre, consultez Effectuer des appels à WMI.

[in] pResponseHandler

Pointeur vers une implémentation de IWbemObjectSink implémentée par l’appelant. Ce gestionnaire reçoit la status de la demande de suppression lorsqu’elle devient disponible via la méthode IWbemObjectSink::SetStatus. Si un code d’erreur est retourné, le pointeur IWbemObjectSink fourni n’est pas utilisé. Si WBEM_S_NO_ERROR est retourné, l’implémentation IWbemObjectSink de l’utilisateur est appelée pour indiquer le résultat de l’opération. Windows Management appelle uniquement AddRef sur le pointeur dans les cas où WBEM_S_NO_ERROR retourne. Dans les cas où un code d’erreur est retourné, le nombre de références est le même que lors de l’entrée. Pour obtenir une explication détaillée de ce paramètre, consultez Appel d’une méthode.

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique le statut de l'appel de méthode. La liste suivante répertorie la valeur contenue dans un HRESULT.

Tous les autres codes de retour sont fournis au récepteur d’objets spécifié par le paramètre pReponseHandler via la méthode SetStatus . Les conditions d’erreur, telles que lorsque la classe n’existe pas ou que l’utilisateur n’est pas autorisé à supprimer des classes, sont signalées au gestionnaire. Elles ne sont pas signalées dans le code de retour de cette méthode.

Des codes d’erreur spécifiques à COM peuvent également être retournés si des problèmes réseau vous font perdre la connexion à distance à Windows Management.

Remarques

Si un fournisseur de instance dynamique est associé à la classe , le fournisseur est désinscrit et n’est plus appelé pour cette classe. Toutes les classes qui dérivent de la classe supprimée sont également supprimées et leurs fournisseurs associés sont désinscrits. Toutes les instances statiques en attente de la classe spécifiée et de ses sous-classes sont également supprimées lorsque la classe est supprimée.

Si la classe est fournie par un fournisseur de classes dynamiques, la réussite de la suppression dépend de la prise en charge ou non de la suppression de classe par ce fournisseur.

Note Les classes système standard ne peuvent pas être supprimées.

 

Étant donné que le rappel peut ne pas être retourné au même niveau d’authentification que celui requis par le client, il est recommandé d’utiliser des semi-synchrones au lieu d’une communication asynchrone. Si vous avez besoin d’une communication asynchrone, consultez Appel d’une méthode.

Pour plus d’informations sur l’utilisation de méthodes semi-synchronisées, consultez IWbemServices::D eleteClass et Appel d’une méthode.

Configuration requise

Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	wbemcli.h (include Wbemidl.h)
Bibliothèque	Wbemuuid.lib
DLL	Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll

Voir aussi

IWbemServices

IWbemServices::D eleteClass

Récupération d’un code d’erreur