Partager via

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

  • Article

[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.
Pour plus d’informations sur la suppression d’instances, consultez IWbemServices ::D eleteInstance.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête provider.h (include FwCommon.h)
Bibliothèque FrameDyn.lib
DLL FrameDynOS.dll ; FrameDyn.dll