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.

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

Voir aussi

Appel d’une méthode

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

IWbemServices

IWbemServices::DeleteInstance