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

La méthode IWbemServices::D eleteInstanceAsync supprime de façon asynchrone un instance d’une classe existante dans l’espace de noms actuel. La confirmation ou l’échec de l’opération est signalé via l’interface IWbemObjectSink implémentée par l’appelant.

Syntaxe

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

Paramètres

[in] strObjectPath

BSTR valide qui contient le chemin d’accès de l’objet à supprimer.

[in] lFlags

WBEM_FLAG_SEND_STATUS inscrit auprès de Windows Management une demande de réception de rapports status intermédiaires via 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. Notez que l’indicateur WBEM_FLAG_USE_AMENDED_QUALIFIERS ne peut pas être utilisé ici.

[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 le instance. Les valeurs de l’objet de contexte doivent être spécifiées dans la documentation du fournisseur en question.

[in] pResponseHandler

Pointeur vers l’implémentation de IWbemObjectSink par l’appelant. Ce gestionnaire reçoit le status de l’opération de suppression à mesure qu’il devient disponible via la méthode 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 plus d’informations, consultez Appel d’une méthode.

Valeur retournée

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

En cas d’échec, vous pouvez obtenir toutes les informations disponibles à partir de la fonction COM GetErrorInfo.

Si DeleteInstanceAsync retourne WBEM_S_NO_ERROR, WMI attend un résultat de la méthode SetStatus du gestionnaire de réponses. WMI attend indéfiniment sur une connexion locale, ou jusqu’à ce qu’un délai d’expiration de connexion à distance se produise.

D’autres conditions d’erreur sont signalées de manière asynchrone au récepteur d’objets fourni par le paramètre pResponseHandler .

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.

Note Les clients qui appellent DeleteInstanceAsync doivent toujours s’attendre à ce que les résultats de l’appel soient signalés à l’aide de leur méthode IWbemObjectSink::Indicate .

 

Note Lorsque le instance pointé par strObjectPath appartient à une classe membre d’une hiérarchie de classes, la réussite de DeleteInstanceAsync dépend du fournisseur non abstrait le plus élevé. Pour obtenir une explication détaillée des dépendances impliquées qui déterminent la réussite de cette opération, consultez Remarques dans IWbemServices::D eleteInstance.

 

Remarques

Un fournisseur de instance peut signaler la réussite ou l’échec avec le code de retour de DeleteInstanceAsync ou via un appel à SetStatus effectué via pResponseHandler. S’il est envoyé à SetStatus, le code de retour envoyé au récepteur via pResponseHandler est prioritaire. É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 données semi-synchronisées 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 eleteInstance 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

Appel d’une méthode

Description d’un chemin d’accès à un objet d’instance

IWbemServices

IWbemServices::DeleteInstance