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.
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 |