Provider ::Commit, méthode (provider.h)

Article
03/04/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 Commit est utilisée pour envoyer un instance à WMI. Cette méthode est une fonction d’assistance et ne doit pas être remplacée.

Syntaxe

HRESULT Commit(
  CInstance *pInstance,
  bool      bCache
);

Paramètres

pInstance

Pointeur vers le instance à stocker par WMI.

bCache

Indique si un cache est implémenté. Cette valeur doit être définie sur FALSE dans la version actuelle de l’infrastructure du fournisseur.

Valeur retournée

Utilisez les macros SUCCEEDED ou FAILED sur le HRESULT retourné pour déterminer si la méthode a réussi.

Remarques

Si le client annule la requête, la méthode Commit retourne une erreur. Un writer de fournisseur peut utiliser ce fait pour mettre fin à une énumération.

En outre, cette méthode appelle CInstance ::Release sur le pointeur pInstance . Pour cette raison, le fournisseur d’infrastructure doit veiller à ne pas appeler à nouveau CInstance ::Release. Cela signifie qu’un pointeur intelligent pInstance est incompatible avec cette méthode, car le pointeur intelligent appelle CInstance ::Release dans son destructeur.

Cette méthode ne doit être utilisée que lorsque le fournisseur d’infrastructure n’appelle pas CInstance ::Release sur le pointeur pInstance séparément et si le pointeur pInstance n’est pas et ne sera jamais un pointeur intelligent.

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

Partager via