Partager via


Méthode Provider ::P utInstance(IWbemClassObject*,long,MethodContext*) (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 PutInstance met à jour un instance.

Syntaxe

HRESULT PutInstance(
  IWbemClassObject *pInst,
  long             lFlags,
  MethodContext    *pContext
);

Paramètres

pInst

TBD

lFlags

Masque de bits d’indicateurs avec des informations sur l’opération de mise à jour. Il s’agit de la valeur spécifiée par le client dans la méthode IWbemServices ::P utInstance .

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

  • WBEM_FLAG_RETURN_IMMEDIATELY
Les valeurs lFlags valides sont les suivantes :
  • WBEM_FLAG_CREATE_ONLY
  • WBEM_FLAG_CREATE_OR_UPDATE
  • WBEM_FLAG_UPDATE_ONLY

pContext

TBD

Valeur retournée

L’implémentation du fournisseur d’infrastructure par défaut de cette méthode retourne WBEM_E_PROVIDER_NOT_CAPABLE à la méthode appelante. La méthode IWbemServices ::P utInstance répertorie les valeurs de retour les plus courantes, même si vous pouvez choisir de retourner n’importe quel code de retour COM.

Remarques

WMI appelle PutInstance lorsqu’un client appelle IWbemServices ::P utInstance sur votre classe. Vous devez implémenter PutInstance si votre fournisseur d’infrastructure met à jour des instances. La liste suivante décrit une implémentation courante de PutInstance :

  1. Examinez les propriétés de clé transmises par le client avec les méthodes Get pour CInstance, telles que CInstance ::GetCHString.

    Votre implémentation doit déterminer si votre fournisseur prend en charge les modifications demandées par le client.

  2. Créez ou mettez à jour l’objet managé approprié, si nécessaire.
  3. Retourne la valeur de retour appropriée.

    Si votre fournisseur ne prend pas en charge les modifications demandées par le client, vous devez retourner un code d’erreur approprié. Pour obtenir la liste complète des codes d’erreur valides, consultez IWbemServices ::P utInstance.

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 (inclure FwCommon.h)
Bibliothèque FrameDyn.lib
DLL FrameDynOS.dll ; FrameDyn.dll