Méthode Provider ::D eleteInstance(constCInstance&,long) (provider.h)

[La classe Provider fait partie de L’infrastructure de fournisseur WMI, qui est maintenant considérée dans l’état final, et aucun développement, amélioration ou mise à jour supplémentaire ne sera disponible pour les problèmes non liés à la sécurité affectant ces bibliothèques. Les API MI doivent être utilisées dans tout nouveau développement.]

La méthode DeleteInstance est appelée par WMI pour supprimer un instance.

Syntaxe

HRESULT DeleteInstance(
  [ref] const CInstance & newInstance,
        long              lFlags
);

Paramètres

[ref] newInstance

Instance à supprimer.

lFlags

Masque de bits des indicateurs avec des informations sur l’opération de suppression. Il s’agit de la valeur spécifiée par le client dans la fonction IWbemServices ::D eleteInstance .

L’indicateur suivant est géré par (et filtré) par WMI :

• WBEM_FLAG_RETURN_IMMEDIATELY

Valeur retournée

L’implémentation du fournisseur d’infrastructure par défaut de cette méthode retourne WBEM_E_PROVIDER_NOT_CAPABLE à la fonction appelante. La fonction IWbemServices ::D eleteInstance répertorie les valeurs de retour les plus courantes, bien que vous puissiez choisir de retourner n’importe quel code de retour COM.

Remarques

WMI appelle DeleteInstance lorsqu’un client appelle IWbemServices ::D eleteInstance sur une classe. Par conséquent, vous devez implémenter DeleteInstance si votre fournisseur d’infrastructure prend en charge la suppression d’instances. La liste suivante décrit une implémentation courante de DeleteInstance :

1. Déterminez les instance le client demandé en lisant les propriétés de clé avec l’une des méthodes Get pour CInstance, comme CInstance ::GetCHString.
2. Supprimez le instance.

Configuration requise