Classe de fournisseur (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 classe Provider est la classe de base pour la ou les classes que le fournisseur d’infrastructure prend en charge. La classe Provider encapsule les implémentations des méthodes d’IWbemServices et inclut plusieurs fonctions d’assistance. Un fournisseur d’infrastructure remplace l’une des méthodes de la classe Provider pour chaque fonctionnalité qu’il prend en charge. Par exemple, un fournisseur qui prend en charge le traitement des requêtes remplace la méthode Provider ::ExecQuery .

Une instance de la classe Provider est créée pour chaque classe WMI qui a un fournisseur d’infrastructure.

Le fournisseur a les types de membres suivants :

Méthode	Description
Commiter	Retourne le instance actuel à WMI.
CreateNewInstance	Alloue un nouvel objet CInstance et retourne un pointeur vers celui-ci.
DeleteInstance	Supprime un instance. Appelé par WMI.
EnumerateInstances	Récupère toutes les instances de la classe d’un fournisseur d’infrastructure. Appelé par WMI.
ExecMethod	Appelle une méthode sur une classe ou un instance. Appelé par WMI.
ExecQuery	Traite une requête WQL (WMI Query Language). Appelé par WMI.
Purge	Appelé par l’infrastructure du fournisseur pour supprimer toute la mémoire inutile utilisée par le fournisseur.
GetLocalComputerName	Retourne une référence constante au nom de l’ordinateur au format CHString .
GetLocalInstancePath	Tente de générer un chemin d’accès d’objet complet à un instance spécifié.
Getobject	Récupère un instance d’une classe. Appelé par WMI.
GetProviderName	Récupère le nom du fournisseur.
MakeLocalPath	Génère un chemin d’accès instance complet à partir d’un chemin relatif.
PutInstance	Mises à jour un instance. Appelé par WMI.
SetCreationClassName	Définit la propriété de chaîne CreationClassName du instance donné sur le nom de ce fournisseur.
ValidateDeletionFlags	Détermine si un ensemble d’indicateurs est valide pour une opération de suppression.
ValidateEnumerationFlags	Détermine si un ensemble d’indicateurs est valide pour une énumération.
ValidateFlags	Détermine si un ensemble d’indicateurs est valide.
ValidateGetObjFlags	Détermine si un ensemble d’indicateurs est valide pour une opération de récupération de instance.
ValidateMethodFlags	Détermine si un ensemble d’indicateurs est valide pour une opération de méthode d’exécution.
ValidatePutInstanceFlags	Détermine si un ensemble d’indicateurs est valide pour une opération de mise à jour instance.
ValidateQueryFlags	Détermine si un ensemble d’indicateurs est valide pour une opération de requête.

Héritage

La classe Provider implémente CThreadBase.

Méthodes

La classe Provider possède ces méthodes.

Provider ::~Provider La fonction Provider ::~Provider est un destructeur pour la classe Provider.
Provider ::Commit 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.
Provider ::CreateNewInstance La méthode CreateNewInstance alloue un nouvel objet CInstance et retourne un pointeur vers celui-ci.
Provider ::D eleteInstance La méthode DeleteInstance est appelée par WMI pour supprimer un instance. (surcharge 2/2)
Provider ::D eleteInstance La méthode DeleteInstance est appelée par WMI pour supprimer un instance. (surcharge 1/2)
Provider ::EnumerateInstances La méthode EnumerateInstances est appelée par WMI pour récupérer toutes les instances de la classe d’un fournisseur d’infrastructure.
Provider ::ExecMethod La méthode ExecMethod est appelée par WMI pour appeler une méthode sur une classe ou un instance. (surcharge 1/2)
Provider ::ExecMethod La méthode ExecMethod est appelée par WMI pour appeler une méthode sur une classe ou un instance. (surcharge 2/2)
Provider ::ExecQuery La méthode ExecQuery est appelée par WMI pour traiter une requête WQL (WMI Query Language).
Provider ::Flush La méthode Flush est appelée par l’infrastructure du fournisseur pour supprimer toute la mémoire inutile utilisée par le fournisseur.
Provider ::GetLocalComputerName La méthode GetLocalComputerName retourne une référence constante au nom de l’ordinateur au format CHString.
Provider ::GetLocalInstancePath La méthode GetLocalInstancePath tente de créer un chemin d’accès d’objet complet à un instance spécifié. Cette méthode est une fonction d’assistance et ne doit pas être remplacée.
Provider ::GetNamespace La méthode GetNamespace retourne une référence constante au nom de l’espace de noms au format CHString. Le nom retourné est le deuxième paramètre initialement donné au constructeur du fournisseur.
Provider ::GetObject La méthode GetObject est appelée par WMI pour récupérer un instance d’une classe. (surcharge 1/3)
Provider ::GetObject La méthode GetObject est appelée par WMI pour récupérer un instance d’une classe. (surcharge 2/3)
Provider ::GetObject La méthode GetObject est appelée par WMI pour récupérer un instance d’une classe. (surcharge 3/3)
Provider ::GetProviderName La méthode GetProviderName récupère le nom de la classe utilisée dans le constructeur du fournisseur.
Provider ::MakeLocalPath La méthode MakeLocalPath génère un chemin d’instance complet à partir d’un chemin relatif.
Provider ::P rovider La méthode Provider crée un instance d’un fournisseur. Cette méthode fait partie de l’infrastructure du fournisseur WMI.
Provider ::P utInstance La méthode PutInstance met à jour un instance. (surcharge 2/2)
Provider ::P utInstance La méthode PutInstance met à jour un instance. (surcharge 1/2)
Provider ::SetCreationClassName La méthode SetCreationClassName définit la propriété de chaîne CreationClassName, le cas échéant, du instance donné sur le nom de ce fournisseur.
Provider ::ValidateDeletionFlags La méthode ValidateDeletionFlags détermine si un ensemble d’indicateurs est valide pour une opération de suppression.
Provider ::ValidateEnumerationFlags La méthode ValidateEnumerationFlags détermine si un ensemble d’indicateurs est valide pour une énumération.
Provider ::ValidateFlags La méthode ValidateFlags détermine si un ensemble d’indicateurs est valide.
Provider ::ValidateGetObjFlags La méthode ValidateGetObjFlags détermine si un ensemble d’indicateurs est valide pour une opération de récupération de instance.
Provider ::ValidateMethodFlags La méthode ValidateMethodFlags détermine si un ensemble d’indicateurs est valide pour une opération de méthode d’exécution.
Provider ::ValidatePutInstanceFlags La méthode ValidatePutInstanceFlags détermine si un ensemble d’indicateurs est valide pour une opération de mise à jour instance.
Provider ::ValidateQueryFlags La méthode ValidateQueryFlags détermine si un ensemble d’indicateurs est valide pour une opération de requête.

Remarques

Le destructeur de cette classe est Provider ::~Provider.

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)