Méthode Provider ::P utInstance(constCInstance&,long) (provider.h)

Article
01/10/2024

[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(
  [ref] const CInstance & newInstance,
        long              lFlags
);

Paramètres

[ref] newInstance

Instance mise à jour.

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

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 :

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.
Créez ou mettez à jour l’objet managé approprié, si nécessaire.
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

Partager via